pan-stack-cli 0.2.1 → 0.2.3

package/lib/manifest.js

@@ -1,467 +0,0 @@
-const fs = require("fs");
-const path = require("path");
-const { t } = require("./i18n");
-
-const PLACEHOLDER_VALUES = new Set(["", "repo_url_to_be_filled", "pan_stack_repo_url"]);
-
-function cleanValue(value) {
-  let result = String(value || "").trim();
-  const commentIndex = result.indexOf(" #");
-  if (commentIndex >= 0) {
-    result = result.slice(0, commentIndex).trimEnd();
-  }
-  if (
-    (result.startsWith('"') && result.endsWith('"')) ||
-    (result.startsWith("'") && result.endsWith("'"))
-  ) {
-    result = result.slice(1, -1);
-  }
-  return result;
-}
-
-function splitKeyValue(text) {
-  const index = text.indexOf(":");
-  if (index < 0) {
-    return [text.trim(), ""];
-  }
-  return [text.slice(0, index).trim(), cleanValue(text.slice(index + 1))];
-}
-
-function parseManifest(manifestPath) {
-  const data = { repositories: [], stack: {}, commands: {} };
-  let section = "";
-  let currentRepo = null;
-  let currentCommandName = "";
-  let currentCommand = null;
-  let currentTargetName = "";
-  let blockMode = null;
-  let blockIndent = 0;
-  let blockLines = [];
-
-  function flushBlock() {
-    if (!blockMode || !currentCommand) {
-      blockMode = null;
-      blockLines = [];
-      return;
-    }
-    const body = blockLines.join("\n");
-    if (blockMode === "command-shell") {
-      currentCommand.shell = body;
-    } else if (blockMode === "command-sequence") {
-      currentCommand.sequence = body;
-    } else if (blockMode === "target-shell" && currentCommand.targets[currentTargetName]) {
-      currentCommand.targets[currentTargetName].shell = body;
-    }
-    blockMode = null;
-    blockLines = [];
-  }
-
-  const lines = fs.readFileSync(manifestPath, "utf8").split(/\r?\n/);
-  for (const rawLine of lines) {
-    if (blockMode) {
-      const trimmed = rawLine.trimEnd();
-      if (!trimmed.trim()) {
-        blockLines.push("");
-        continue;
-      }
-      const indent = rawLine.length - rawLine.trimStart().length;
-      if (indent < blockIndent) {
-        flushBlock();
-      } else {
-        blockLines.push(rawLine.slice(blockIndent));
-        continue;
-      }
-    }
-
-    if (!rawLine.trim() || rawLine.trimStart().startsWith("#")) {
-      continue;
-    }
-
-    const indent = rawLine.length - rawLine.trimStart().length;
-    const text = rawLine.trim();
-
-    if (indent === 0) {
-      flushBlock();
-      const [key, value] = splitKeyValue(text);
-      section = key;
-      currentRepo = null;
-      currentCommandName = "";
-      currentCommand = null;
-      currentTargetName = "";
-      if (value) {
-        data[key] = value;
-      } else if (!(key in data)) {
-        data[key] = key === "commands" ? {} : {};
-      }
-      continue;
-    }
-
-    if (section === "stack" && indent === 2) {
-      const [key, value] = splitKeyValue(text);
-      data.stack[key] = value;
-      continue;
-    }
-
-    if (section === "repositories") {
-      if (indent === 2 && text.startsWith("- ")) {
-        currentRepo = {};
-        data.repositories.push(currentRepo);
-        const rest = text.slice(2).trim();
-        if (rest) {
-          const [key, value] = splitKeyValue(rest);
-          currentRepo[key] = value;
-        }
-        continue;
-      }
-      if (currentRepo && indent === 4) {
-        const [key, value] = splitKeyValue(text);
-        currentRepo[key] = value;
-      }
-      continue;
-    }
-
-    if (section === "commands") {
-      if (indent === 2) {
-        flushBlock();
-        const [key, value] = splitKeyValue(text);
-        currentCommandName = key;
-        currentCommand = {};
-        currentTargetName = "";
-        data.commands[currentCommandName] = currentCommand;
-        if (value) {
-          currentCommand[key] = value;
-        }
-        continue;
-      }
-
-      if (indent === 4 && currentCommand) {
-        flushBlock();
-        const [key, value] = splitKeyValue(text);
-        if (key === "shell" && (value === "|" || value === ">")) {
-          blockMode = "command-shell";
-          blockIndent = indent + 2;
-          blockLines = [];
-          continue;
-        }
-        if (key === "sequence" && (value === "|" || value === ">")) {
-          blockMode = "command-sequence";
-          blockIndent = indent + 2;
-          blockLines = [];
-          continue;
-        }
-        if (key === "targets") {
-          currentCommand.targets = currentCommand.targets || {};
-          continue;
-        }
-        currentCommand[key] = value;
-        continue;
-      }
-
-      if (indent === 6 && currentCommand) {
-        flushBlock();
-        const [key, value] = splitKeyValue(text);
-        currentTargetName = key;
-        currentCommand.targets = currentCommand.targets || {};
-        const target = {};
-        currentCommand.targets[currentTargetName] = target;
-        if (value) {
-          target[key] = value;
-        }
-        if (key === "shell" && (value === "|" || value === ">")) {
-          blockMode = "target-shell";
-          blockIndent = indent + 2;
-          blockLines = [];
-        }
-        continue;
-      }
-
-      if (indent === 8 && currentCommand && currentCommand.targets && currentTargetName) {
-        flushBlock();
-        const target = currentCommand.targets[currentTargetName];
-        const [key, value] = splitKeyValue(text);
-        if (key === "shell" && (value === "|" || value === ">")) {
-          blockMode = "target-shell";
-          blockIndent = indent + 2;
-          blockLines = [];
-          continue;
-        }
-        target[key] = value;
-      }
-    }
-  }
-
-  flushBlock();
-  return data;
-}
-
-function uniqueRepos(repos) {
-  const seen = new Set();
-  const result = [];
-  for (const repo of repos) {
-    const key = [
-      cleanValue(repo.name),
-      cleanValue(repo.url),
-      cleanValue(repo.path),
-    ].join("\u0000");
-    if (seen.has(key)) {
-      continue;
-    }
-    seen.add(key);
-    result.push(repo);
-  }
-  return result;
-}
-
-function manifestRepos(data) {
-  return uniqueRepos(data.repositories || []);
-}
-
-function validateRepo(repo) {
-  const name = cleanValue(repo.name);
-  const url = cleanValue(repo.url);
-  const repoPath = cleanValue(repo.path) || name;
-
-  if (!name) {
-    throw new Error(t("REPO_MISSING_NAME"));
-  }
-  if (PLACEHOLDER_VALUES.has(url)) {
-    throw new Error(t("REPO_MISSING_URL__NAME", { name }));
-  }
-  if (!repoPath) {
-    throw new Error(t("REPO_MISSING_PATH__NAME", { name }));
-  }
-  return { name, url, repoPath };
-}
-
-const LOCAL_MANIFEST_FILE = ".project.local.yaml";
-
-function localManifestPath(manifestPath) {
-  return path.join(path.dirname(manifestPath), LOCAL_MANIFEST_FILE);
-}
-
-/**
- * Parse `.project.yaml` rồi GỘP THÊM `repositories:` từ `.project.local.yaml` cùng thư mục
- * (nếu có) — file cá nhân, KHÔNG commit (gitignore), chỉ cần có field `repositories:`. Dùng để
- * mỗi người tự thêm repo riêng (thử nghiệm, fork cá nhân…) mà không đụng `.project.yaml` chung.
- * Mọi lệnh đọc repo (clone/pull/push/fetch/grv/gst/sync-main/mr/checkout/stats/pan.yaml sources)
- * đều đi qua đây (loadManifest / loadManifestRepos) nên tự động thấy repo local, không cần sửa
- * riêng từng lệnh.
- */
-function parseManifestWithLocal(manifestPath) {
-  const data = parseManifest(manifestPath);
-  const localPath = localManifestPath(manifestPath);
-  if (fs.existsSync(localPath)) {
-    const localData = parseManifest(localPath);
-    const localRepos = Array.isArray(localData.repositories) ? localData.repositories : [];
-    if (localRepos.length) {
-      data.repositories = [...(data.repositories || []), ...localRepos];
-      console.error(`ℹ️  +${localRepos.length} repo từ ${LOCAL_MANIFEST_FILE}`);
-    }
-  }
-  return data;
-}
-
-function loadManifest(manifestPath) {
-  const resolved = path.resolve(manifestPath);
-  if (!fs.existsSync(resolved)) {
-    throw new Error(t("MANIFEST_NOT_FOUND__PATH", { path: manifestPath }));
-  }
-  const data = parseManifestWithLocal(resolved);
-  return {
-    path: resolved,
-    root: path.dirname(resolved),
-    project: cleanValue(data.project) || path.basename(path.dirname(resolved)),
-    managedBy: cleanValue(data.managed_by),
-    stack: data.stack || {},
-    repositories: manifestRepos(data),
-    commands: data.commands || {},
-  };
-}
-
-const PAN_CONFIG_FILE = ".pan.yaml";
-
-function loadPanConfig(configPath, meta = {}) {
-  const resolved = path.resolve(configPath);
-  if (!fs.existsSync(resolved)) {
-    throw new Error(t("CONFIG_NOT_FOUND__PATH", { path: configPath }));
-  }
-  const data = parseManifest(resolved);
-  const root = path.dirname(resolved);
-  return {
-    path: resolved,
-    root,
-    workspaceRoot: meta.workspaceRoot || root,
-    project: cleanValue(data.project) || meta.project || path.basename(root),
-    repoName: meta.repoName || "",
-    scope: meta.scope || "repo",
-    commands: data.commands || {},
-  };
-}
-
-function commandAliases(def) {
-  if (!def) {
-    return [];
-  }
-  const result = [];
-  if (def.alias) {
-    result.push(cleanValue(def.alias));
-  }
-  if (def.aliases) {
-    const raw = def.aliases;
-    if (Array.isArray(raw)) {
-      result.push(...raw.map((item) => cleanValue(item)));
-    } else {
-      const value = cleanValue(raw);
-      if (value.startsWith("[") && value.endsWith("]")) {
-        result.push(
-          ...value
-            .slice(1, -1)
-            .split(",")
-            .map((item) => cleanValue(item))
-            .filter(Boolean)
-        );
-      } else if (value.includes(",")) {
-        result.push(
-          ...value
-            .split(",")
-            .map((item) => cleanValue(item))
-            .filter(Boolean)
-        );
-      } else if (value) {
-        result.push(value);
-      }
-    }
-  }
-  return [...new Set(result.filter(Boolean))];
-}
-
-function resolveCommandName(sources, commandName) {
-  if (sources.some((source) => source.commands[commandName])) {
-    return commandName;
-  }
-  for (const source of sources) {
-    for (const [primaryName, def] of Object.entries(source.commands || {})) {
-      if (commandAliases(def).includes(commandName)) {
-        return primaryName;
-      }
-    }
-  }
-  return commandName;
-}
-
-function getCommandDefinition(source, commandName, subArg) {
-  const def = source.commands[commandName];
-  if (!def) {
-    return null;
-  }
-
-  if (def.targets && typeof def.targets === "object") {
-    const targetName = subArg || def.default || Object.keys(def.targets)[0];
-    const target = def.targets[targetName];
-    if (!target) {
-      const valid = Object.keys(def.targets).join(" | ");
-      throw new Error(t("VALID_TARGETS__COMMAND_VALID", { command: commandName, valid }));
-    }
-    return {
-      ...target,
-      targetName,
-      description: def.description,
-    };
-  }
-
-  return def;
-}
-
-function listCommands(source) {
-  return Object.entries(source.commands || {})
-    .map(([name, def]) => ({
-      name,
-      aliases: commandAliases(def),
-      description: def.description || "",
-      hasTargets: Boolean(def.targets),
-      targets: def.targets ? Object.keys(def.targets) : [],
-      hasSequence: Boolean(def.sequence),
-    }))
-    // Sort A-Z theo tên lệnh — dễ dò trong menu tương tác (`pan` trống) và list help (`pan -h`),
-    // thay vì theo thứ tự khai báo trong .pan.yaml (khó đoán khi file có nhiều lệnh).
-    .sort((a, b) => a.name.localeCompare(b.name));
-}
-
-/**
- * Parse field `sequence` của 1 command → danh sách step chạy TUẦN TỰ theo thứ tự.
- * 2 cách viết:
- *   sequence: build-fe, build-be              # 1 dòng, phân tách bởi ,
- *   sequence: |                               # nhiều dòng (khuyến nghị khi cần set biến)
- *     build-fe
- *     MODE=prod build-be:dev
- *     build-extra?                            # dấu ? cuối = optional (lỗi vẫn chạy tiếp bước sau)
- * Mỗi dòng: [KEY=VAL ...] tênLệnh[:target][?]
- *   • tênLệnh phải là 1 command KHÁC đã khai báo trong CÙNG file .pan.yaml này.
- *   • `:target` chọn target nếu lệnh đó có `targets:`.
- *   • `KEY=VAL` (đặt trước tên lệnh, cách nhau bởi khoảng trắng) → biến môi trường CHỈ áp dụng
- *     cho riêng bước đó (không ảnh hưởng các bước khác).
- *   • `?` cuối tên lệnh → bước lỗi (exit code != 0) KHÔNG dừng cả sequence, chỉ cảnh báo rồi
- *     chạy tiếp bước sau. Không có `?` → lỗi là DỪNG NGAY (không chạy bước còn lại).
- */
-function parseSequenceSteps(raw) {
-  const text = String(raw || "");
-  const lines = text.includes("\n") ? text.split(/\r?\n/) : text.split(",");
-  const steps = [];
-  for (const rawLine of lines) {
-    const line = rawLine.trim();
-    if (!line || line.startsWith("#")) {
-      continue;
-    }
-    const tokens = line.split(/\s+/).filter(Boolean);
-    const env = {};
-    let ref = null;
-    for (const token of tokens) {
-      const match = ref === null && token.match(/^([A-Za-z_][A-Za-z0-9_]*)=(.*)$/);
-      if (match) {
-        env[match[1]] = cleanValue(match[2]);
-        continue;
-      }
-      if (ref !== null) {
-        throw new Error(`Invalid sequence step: "${line}" (expected "[KEY=VAL ...] commandName[:target][?]")`);
-      }
-      ref = token;
-    }
-    if (!ref) {
-      continue;
-    }
-    let optional = false;
-    if (ref.endsWith("?")) {
-      optional = true;
-      ref = ref.slice(0, -1);
-    }
-    const [name, target = ""] = ref.split(":");
-    if (!name) {
-      throw new Error(`Invalid sequence step: "${line}" — missing command name.`);
-    }
-    steps.push({ raw: line, name, target, env, optional });
-  }
-  return steps;
-}
-
-function commandBaseDir(source) {
-  return source.scope === "workspace" ? source.workspaceRoot : source.root;
-}
-
-module.exports = {
-  PLACEHOLDER_VALUES,
-  PAN_CONFIG_FILE,
-  LOCAL_MANIFEST_FILE,
-  cleanValue,
-  parseManifest,
-  parseManifestWithLocal,
-  loadManifest,
-  loadPanConfig,
-  manifestRepos,
-  validateRepo,
-  commandAliases,
-  resolveCommandName,
-  getCommandDefinition,
-  parseSequenceSteps,
-  listCommands,
-  commandBaseDir,
-};

package/lib/menu-prompt.js

@@ -1,201 +0,0 @@
-// Custom @inquirer prompt: danh sách chọn (↑↓/Enter, gõ chữ lọc) + PHÍM TẮT NHẤN-1-PHÍM chạy ngay
-// (vd h/v/b/x). Dùng @inquirer/core (dynamic ESM từ CJS). Thiếu core → menuSelect throw 'no-core'
-// để caller fallback sang @inquirer/prompts select.
-let cachePrompt = null;
-
-async function buildMenuPrompt() {
-  if (cachePrompt) return cachePrompt;
-  const core = await import("@inquirer/core").catch(() => null);
-  if (!core) return null;
-  const {
-    createPrompt, useState, useKeypress, usePrefix, usePagination, useMemo,
-    isEnterKey, isUpKey, isDownKey, Separator, makeTheme,
-  } = core;
-
-  cachePrompt = createPrompt((config, done) => {
-    const { message, choices, hotkeys = [], pageSize = 15, footer = "" } = config;
-    const theme = makeTheme(config.theme);
-    const [status, setStatus] = useState("idle");
-    const prefix = usePrefix({ status, theme });
-    const items = useMemo(() => choices, [choices]);
-    const firstSel = items.findIndex((it) => !Separator.isSeparator(it));
-    const [active, setActive] = useState(firstSel < 0 ? 0 : firstSel);
-
-    useKeypress((key, rl) => {
-      if (status !== "idle") return;
-      if (isEnterKey(key)) {
-        const it = items[active];
-        if (it && !Separator.isSeparator(it) && !it.disabled) {
-          setStatus("done");
-          done(it.value);
-        }
-      } else if (isUpKey(key) || isDownKey(key)) {
-        rl.clearLine(0);
-        const dir = isUpKey(key) ? -1 : 1;
-        let n = active;
-        do {
-          n = (n + dir + items.length) % items.length;
-        } while (Separator.isSeparator(items[n]) && n !== active);
-        setActive(n);
-      } else if (key.name && hotkeys.some((h) => h.key === key.name)) {
-        // PHÍM TẮT: nhấn 1 phím → chạy ngay.
-        setStatus("done");
-        done(hotkeys.find((h) => h.key === key.name).value);
-      } else {
-        // type-ahead: nhảy tới item tên bắt đầu bằng ký tự đang gõ.
-        const term = String(rl.line || "").toLowerCase();
-        if (term) {
-          const idx = items.findIndex(
-            (it) => !Separator.isSeparator(it) && String(it.name).toLowerCase().startsWith(term)
-          );
-          if (idx >= 0) setActive(idx);
-        }
-      }
-    });
-
-    const activeItem = items[active] || {};
-    if (status === "done") {
-      return `${prefix} ${message} ${activeItem.name || ""}`.trim();
-    }
-
-    const page = usePagination({
-      items,
-      active,
-      renderItem({ item, isActive }) {
-        if (Separator.isSeparator(item)) return `  ${item.separator || "──────────"}`;
-        const cursor = isActive ? "❯" : " ";
-        const line = ` ${cursor} ${item.name}`;
-        return isActive ? `\x1b[36m${line}\x1b[39m` : line;
-      },
-      pageSize,
-      loop: false,
-    });
-
-    const desc = activeItem.description ? `\x1b[2m  ${activeItem.description}\x1b[22m` : "";
-    const hk = hotkeys.length
-      ? "  " + hotkeys.map((h) => `\x1b[1m${h.key}\x1b[22m ${h.label}`).join(" · ")
-      : "";
-    const help = footer || hk ? `\x1b[2m${footer}\x1b[22m${hk}` : "";
-    return [`${prefix} ${message}`, page, desc, help].filter(Boolean).join("\n");
-  });
-  return cachePrompt;
-}
-
-async function menuSelect(config) {
-  const prompt = await buildMenuPrompt();
-  if (!prompt) throw new Error("no-core");
-  return prompt(config);
-}
-
-// Multi-select với phím tắt (x thoát, b quay lại...) — trả:
-//   { action: 'submit', values: string[] } khi Enter
-//   { action: <hotkey.value> } khi bấm hotkey
-let cachePromptCheckbox = null;
-
-async function buildMenuCheckbox() {
-  if (cachePromptCheckbox) return cachePromptCheckbox;
-  const core = await import("@inquirer/core").catch(() => null);
-  if (!core) return null;
-  const {
-    createPrompt, useState, useKeypress, usePrefix, usePagination, useMemo,
-    isEnterKey, isUpKey, isDownKey, isSpaceKey, Separator, makeTheme,
-  } = core;
-
-  cachePromptCheckbox = createPrompt((config, done) => {
-    const { message, choices, hotkeys = [], pageSize = 15, footer = "" } = config;
-    const theme = makeTheme(config.theme);
-    const [status, setStatus] = useState("idle");
-    const prefix = usePrefix({ status, theme });
-    const items = useMemo(() => choices, [choices]);
-    const firstSel = items.findIndex((it) => !Separator.isSeparator(it));
-    const [active, setActive] = useState(firstSel < 0 ? 0 : firstSel);
-    const [checked, setChecked] = useState(new Set());
-
-    function toggle(i) {
-      const it = items[i];
-      if (!it || Separator.isSeparator(it) || it.disabled) return;
-      const next = new Set(checked);
-      if (next.has(i)) next.delete(i);
-      else next.add(i);
-      setChecked(next);
-    }
-
-    useKeypress((key, rl) => {
-      if (status !== "idle") return;
-      if (isEnterKey(key)) {
-        setStatus("done");
-        const values = [];
-        items.forEach((it, i) => {
-          if (!Separator.isSeparator(it) && !it.disabled && checked.has(i)) values.push(it.value);
-        });
-        done({ action: "submit", values });
-      } else if (isSpaceKey && isSpaceKey(key)) {
-        rl.clearLine(0);
-        toggle(active);
-      } else if (key.name === "space") {
-        rl.clearLine(0);
-        toggle(active);
-      } else if (isUpKey(key) || isDownKey(key)) {
-        rl.clearLine(0);
-        const dir = isUpKey(key) ? -1 : 1;
-        let n = active;
-        do {
-          n = (n + dir + items.length) % items.length;
-        } while (Separator.isSeparator(items[n]) && n !== active);
-        setActive(n);
-      } else if (key.name === "a") {
-        // toggle-all: nếu chưa đủ → chọn hết; đã đủ → bỏ hết
-        const selectable = items.map((it, i) => ({ it, i })).filter(({ it }) => !Separator.isSeparator(it) && !it.disabled);
-        const allChecked = selectable.every(({ i }) => checked.has(i));
-        const next = new Set();
-        if (!allChecked) selectable.forEach(({ i }) => next.add(i));
-        setChecked(next);
-      } else if (key.name === "i") {
-        // invert
-        const next = new Set();
-        items.forEach((it, i) => {
-          if (!Separator.isSeparator(it) && !it.disabled && !checked.has(i)) next.add(i);
-        });
-        setChecked(next);
-      } else if (key.name && hotkeys.some((h) => h.key === key.name)) {
-        setStatus("done");
-        done({ action: hotkeys.find((h) => h.key === key.name).value });
-      }
-    });
-
-    if (status === "done") {
-      return `${prefix} ${message}`.trim();
-    }
-
-    const page = usePagination({
-      items,
-      active,
-      renderItem({ item, index, isActive }) {
-        if (Separator.isSeparator(item)) return `  ${item.separator || "──────────"}`;
-        const box = checked.has(index) ? "◉" : "◯";
-        const cursor = isActive ? "❯" : " ";
-        const line = ` ${cursor} ${box} ${item.name}`;
-        return isActive ? `\x1b[36m${line}\x1b[39m` : line;
-      },
-      pageSize,
-      loop: false,
-    });
-
-    const baseHelp = "space chọn · a chọn tất cả · i đảo";
-    const hk = hotkeys.length
-      ? "  " + hotkeys.map((h) => `\x1b[1m${h.key}\x1b[22m ${h.label}`).join(" · ")
-      : "";
-    const enterTip = `  \x1b[1mEnter\x1b[22m \x1b[2mxác nhận\x1b[22m`;
-    const help = `\x1b[2m${footer || baseHelp}\x1b[22m${hk}${enterTip}`;
-    return [`${prefix} ${message}`, page, help].filter(Boolean).join("\n");
-  });
-  return cachePromptCheckbox;
-}
-
-async function menuCheckbox(config) {
-  const prompt = await buildMenuCheckbox();
-  if (!prompt) throw new Error("no-core");
-  return prompt(config);
-}
-
-module.exports = { menuSelect, buildMenuPrompt, menuCheckbox, buildMenuCheckbox };