pan-stack-cli 0.1.5 → 0.2.1

package/lib/stats/review.js

@@ -0,0 +1,157 @@
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+const { execFileSync } = require("child_process");
+const { toGitDate } = require("./range");
+
+/**
+ * Xuất code change của 1 thành viên trong 1 dự án theo khoảng thời gian ra
+ * file Markdown để đưa AI review/chấm điểm.
+ * @param {{name,dir}} repo  repo đã resolve (name + đường dẫn tuyệt đối)
+ * @param {string} member    email hoặc tên (dùng làm --author regex của git)
+ * @param {{from,to,label}} range
+ * @param {{withDiff?:boolean, maxDiffLines?:number}} opts
+ * @returns {string} nội dung markdown
+ */
+function buildReviewMarkdown(repo, member, range, opts = {}) {
+  const { withDiff = true, maxDiffLines = 6000, allBranches = true } = opts;
+  const since = toGitDate(range.from);
+  const until = toGitDate(range.to);
+
+  // Mặc định quét mọi nhánh; tắt bằng { allBranches: false }.
+  const baseArgs = ["-C", repo.dir, "log", "--no-merges", `--author=${member}`];
+  if (allBranches) baseArgs.push("--all");
+  if (since) baseArgs.push(`--since=${since}`);
+  if (until) baseArgs.push(`--until=${until}`);
+
+  // 1) Danh sách commit + stat tóm tắt
+  const listRaw = run([
+    ...baseArgs,
+    "--date=format:%Y-%m-%d %H:%M",
+    "--pretty=format:%h\x1f%ad\x1f%an\x1f%ae\x1f%s",
+    "--shortstat",
+  ]);
+  const commits = parseListWithStat(listRaw);
+
+  const totalAdd = commits.reduce((s, c) => s + c.additions, 0);
+  const totalDel = commits.reduce((s, c) => s + c.deletions, 0);
+
+  const lines = [];
+  lines.push(`# Code review — ${repo.name}`);
+  lines.push("");
+  lines.push(`- **Thành viên:** ${member}`);
+  lines.push(`- **Khoảng thời gian:** ${range.label}`);
+  lines.push(`- **Dự án:** ${repo.name}`);
+  lines.push(`- **Sinh lúc:** ${new Date().toISOString()}`);
+  lines.push("");
+  lines.push(`## Tóm tắt`);
+  lines.push("");
+  lines.push(`- Tổng commit: **${commits.length}**`);
+  lines.push(`- Dòng thêm: **+${totalAdd}** · Dòng xoá: **−${totalDel}**`);
+  lines.push("");
+
+  if (commits.length === 0) {
+    lines.push("> Không có commit nào khớp thành viên/khoảng thời gian này.");
+    return lines.join("\n");
+  }
+
+  lines.push(`## Danh sách commit`);
+  lines.push("");
+  lines.push("| Ngày | Commit | Mô tả | +/− |");
+  lines.push("|------|--------|-------|-----|");
+  for (const c of commits) {
+    lines.push(`| ${c.date} | \`${c.hash}\` | ${escapePipe(c.subject)} | +${c.additions}/−${c.deletions} |`);
+  }
+  lines.push("");
+
+  if (withDiff) {
+    lines.push(`## Nội dung thay đổi (diff)`);
+    lines.push("");
+    let emitted = 0;
+    for (const c of commits) {
+      if (emitted >= maxDiffLines) {
+        lines.push(`> …đã cắt bớt diff (vượt ${maxDiffLines} dòng). Dùng \`--no-diff\` hoặc thu hẹp khoảng thời gian.`);
+        break;
+      }
+      const diff = run([
+        "-C",
+        repo.dir,
+        "show",
+        c.hash,
+        "--no-color",
+        "--pretty=format:",
+      ]);
+      const body = diff.split("\n").slice(0, Math.max(0, maxDiffLines - emitted));
+      emitted += body.length;
+      lines.push(`### \`${c.hash}\` — ${c.subject}`);
+      lines.push("");
+      lines.push("```diff");
+      lines.push(body.join("\n").trim());
+      lines.push("```");
+      lines.push("");
+    }
+  }
+
+  lines.push(`---`);
+  lines.push("");
+  lines.push(`## Yêu cầu cho AI reviewer`);
+  lines.push("");
+  lines.push(`Hãy đánh giá phần code thay đổi ở trên và cho **điểm 1–10** kèm nhận xét theo các tiêu chí:`);
+  lines.push("");
+  lines.push(`1. **Tính đúng đắn** — logic có đúng, có bug tiềm ẩn không?`);
+  lines.push(`2. **Chất lượng code** — đặt tên, cấu trúc, trùng lặp, độ phức tạp.`);
+  lines.push(`3. **An toàn & xử lý lỗi** — validate input, edge case, rò rỉ dữ liệu.`);
+  lines.push(`4. **Kiểm thử** — có test kèm theo / có cần bổ sung không?`);
+  lines.push(`5. **Tính nhất quán** — bám theo quy ước dự án.`);
+  lines.push("");
+  lines.push(`Xuất kết quả: bảng điểm từng tiêu chí, điểm tổng, và top 3 điểm cần cải thiện.`);
+
+  return lines.join("\n");
+}
+
+function run(args) {
+  try {
+    return execFileSync("git", args, { encoding: "utf8", maxBuffer: 512 * 1024 * 1024 });
+  } catch (err) {
+    throw new Error(`git lỗi: ${(err.message || "").split("\n")[0]}`);
+  }
+}
+
+/** Parse output của `git log --shortstat --pretty=hash..subject`. */
+function parseListWithStat(raw) {
+  const commits = [];
+  let cur = null;
+  for (const line of raw.split("\n")) {
+    if (line.includes("\x1f")) {
+      if (cur) commits.push(cur);
+      const [hash, date, name, email, subject] = line.split("\x1f");
+      cur = { hash, date, name, email, subject: subject || "", additions: 0, deletions: 0 };
+      continue;
+    }
+    const m = line.match(/(\d+) insertion[s]?\(\+\)|(\d+) deletion[s]?\(-\)/g);
+    if (m && cur) {
+      for (const part of m) {
+        const add = part.match(/(\d+) insertion/);
+        const del = part.match(/(\d+) deletion/);
+        if (add) cur.additions += parseInt(add[1], 10);
+        if (del) cur.deletions += parseInt(del[1], 10);
+      }
+    }
+  }
+  if (cur) commits.push(cur);
+  return commits;
+}
+
+function escapePipe(s) {
+  return String(s || "").replace(/\|/g, "\\|");
+}
+
+/** Ghi ra file, tạo thư mục nếu cần. */
+function writeReview(outFile, content) {
+  fs.mkdirSync(path.dirname(outFile), { recursive: true });
+  fs.writeFileSync(outFile, content);
+  return outFile;
+}
+
+module.exports = { buildReviewMarkdown, writeReview };

package/lib/stats/scan.js

@@ -0,0 +1,92 @@
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+const { execFileSync } = require("child_process");
+const { parseGitLog, PRETTY_FORMAT } = require("./parse");
+const { toGitDate } = require("./range");
+const { validateRepo } = require("../manifest");
+const { discoverGitRepos } = require("../discover");
+
+/**
+ * Từ workspace (.project.yaml) → danh sách repo cần quét kèm đường dẫn tuyệt đối.
+ */
+function reposFromWorkspace(workspace) {
+  const out = [];
+  for (const repo of workspace.repositories) {
+    let name;
+    let repoPath;
+    try {
+      ({ name, repoPath } = validateRepo(repo));
+    } catch {
+      continue; // entry lỗi trong yaml
+    }
+    out.push({ name, dir: path.resolve(workspace.root, repoPath) });
+  }
+  return out;
+}
+
+function isGitRepo(dir) {
+  try {
+    return fs.existsSync(path.join(dir, ".git"));
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Quét 1 repo trong khoảng thời gian. Trả trạng thái sẵn có (available/reason).
+ * pan-stack là vỏ bọc → repo có thể chưa clone / không đọc được.
+ */
+function scanRepo(repo, range, { allBranches = true } = {}) {
+  if (!fs.existsSync(repo.dir)) {
+    return { name: repo.name, available: false, reason: "chưa clone (không có thư mục)", commits: [] };
+  }
+  if (!isGitRepo(repo.dir)) {
+    return { name: repo.name, available: false, reason: "không phải git repo", commits: [] };
+  }
+
+  // Mặc định `--all` → gộp commit trên MỌI nhánh (local + remote-tracking + tags),
+  // git tự dedupe theo hash. Tắt bằng { allBranches: false } (chỉ HEAD hiện tại).
+  const args = ["-C", repo.dir, "log", "--no-merges", "--numstat", "--date=unix", `--pretty=format:${PRETTY_FORMAT}`];
+  if (allBranches) args.push("--all");
+  const since = toGitDate(range.from);
+  const until = toGitDate(range.to);
+  if (since) args.push(`--since=${since}`);
+  if (until) args.push(`--until=${until}`);
+
+  let raw = "";
+  try {
+    raw = execFileSync("git", args, { encoding: "utf8", maxBuffer: 512 * 1024 * 1024 });
+  } catch (err) {
+    return {
+      name: repo.name,
+      available: false,
+      reason: `không đọc được: ${(err.message || "").split("\n")[0]}`,
+      commits: [],
+    };
+  }
+
+  const commits = parseGitLog(raw).map((c) => ({ ...c, repoName: repo.name }));
+  return { name: repo.name, available: true, reason: "", commits };
+}
+
+/**
+ * Quét toàn bộ repo. Trả { commits, repoStatus } — repoStatus gồm cả repo lỗi.
+ */
+function scanAll(repos, range, { log = true, allBranches = true } = {}) {
+  const commits = [];
+  const repoStatus = [];
+  for (const repo of repos) {
+    const res = scanRepo(repo, range, { allBranches });
+    repoStatus.push({ name: res.name, available: res.available, reason: res.reason, commits: res.commits.length });
+    if (log) {
+      const tag = res.available ? `${res.commits.length} commit` : `⚠️  ${res.reason}`;
+      console.log(`  • ${repo.name} ... ${tag}`);
+    }
+    commits.push(...res.commits);
+  }
+  return { commits, repoStatus };
+}
+
+module.exports = { reposFromWorkspace, discoverGitRepos, scanRepo, scanAll, isGitRepo };

package/lib/stats/serve.js

@@ -0,0 +1,25 @@
+"use strict";
+
+const http = require("http");
+const { execFile } = require("child_process");
+
+/** Serve HTML tại localhost và (tuỳ chọn) mở trình duyệt. */
+function serveHtml(html, { port = 4321, open = true } = {}) {
+  const server = http.createServer((req, res) => {
+    res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
+    res.end(html);
+  });
+  server.listen(port, () => {
+    const url = `http://localhost:${port}`;
+    console.log(`\n✅ Báo cáo đang chạy tại ${url}  (Ctrl+C để dừng)`);
+    if (open) openBrowser(url);
+  });
+  return server;
+}
+
+function openBrowser(url) {
+  const cmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
+  execFile(cmd, [url], () => {});
+}
+
+module.exports = { serveHtml };

package/lib/ui/api.js

@@ -0,0 +1,202 @@
+// lib/ui/api.js — HTTP client cho Pan Studio backend (device-flow auth + project/file/export).
+// Dùng Node18 `fetch` global (không thêm dep như axios) — xem docs §3, §4.2.
+// Chỉ ĐỊNH NGHĨA hàm gọi endpoint theo solution §3/§5; backend device-flow/guard đang xây
+// song song nên một số endpoint có thể chưa tồn tại/chưa test được (honest-TODO cuối file).
+
+/**
+ * @typedef {{ apiUrl: string, token?: string }} ApiClientOptions
+ */
+
+/**
+ * Lỗi HTTP có kèm status + body đã parse (nếu là JSON) để caller phân loại.
+ */
+class ApiError extends Error {
+  constructor(message, { status, body } = {}) {
+    super(message);
+    this.name = "ApiError";
+    this.status = status;
+    this.body = body;
+  }
+}
+
+function messageForStatus(status, fallback) {
+  if (status === 401) {
+    return "Chưa đăng nhập hoặc key đã hết hạn — chạy `pan ui init` để đăng nhập lại.";
+  }
+  if (status === 403) {
+    return "Không đủ quyền truy cập tài nguyên này (kiểm tra scope key hoặc quyền dự án).";
+  }
+  if (status === 404) {
+    return "Không tìm thấy tài nguyên (404) — kiểm tra lại id/đường dẫn.";
+  }
+  if (status >= 500) {
+    return `Lỗi máy chủ Pan Studio (${status}) — thử lại sau.`;
+  }
+  return fallback;
+}
+
+/**
+ * @param {string} base - `<apiUrl>/api/v1`
+ * @param {string} pathName
+ * @param {{ method?: string, token?: string, body?: any, headers?: Record<string,string>, raw?: boolean }} [opts]
+ */
+async function request(base, pathName, opts = {}) {
+  const { method = "GET", token, body, headers = {}, raw = false } = opts;
+  const url = `${base}${pathName}`;
+  const finalHeaders = { Accept: "application/json", ...headers };
+  if (token) {
+    finalHeaders.Authorization = `Bearer ${token}`;
+  }
+  let payload;
+  if (body !== undefined && !raw) {
+    finalHeaders["Content-Type"] = "application/json";
+    payload = JSON.stringify(body);
+  } else if (raw) {
+    payload = body;
+  }
+
+  let res;
+  try {
+    res = await fetch(url, { method, headers: finalHeaders, body: payload });
+  } catch (err) {
+    throw new ApiError(
+      `Không kết nối được Pan Studio API (${url}): ${err.message}`,
+      { status: 0 }
+    );
+  }
+
+  const contentType = res.headers.get("content-type") || "";
+  const isJson = contentType.includes("application/json");
+  const text = await res.text();
+  const parsed = isJson && text ? safeJsonParse(text) : text;
+
+  if (!res.ok) {
+    const fallback =
+      (parsed && typeof parsed === "object" && (parsed.message || parsed.error)) ||
+      `HTTP ${res.status} ${res.statusText}`;
+    throw new ApiError(messageForStatus(res.status, fallback), {
+      status: res.status,
+      body: parsed,
+    });
+  }
+
+  return parsed;
+}
+
+function safeJsonParse(text) {
+  try {
+    return JSON.parse(text);
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * @param {ApiClientOptions} options
+ */
+function createApiClient(options) {
+  const apiUrl = String(options.apiUrl || "").replace(/\/+$/, "");
+  const base = `${apiUrl}/api/v1`;
+  const token = options.token;
+
+  const call = (pathName, opts) => request(base, pathName, { token, ...opts });
+
+  return {
+    /** POST /auth/device/start — { clientName, scope, expiresInDays } */
+    deviceStart(opts = {}) {
+      return call("/auth/device/start", { method: "POST", body: opts });
+    },
+
+    /** POST /auth/device/poll — { deviceCode } */
+    devicePoll(deviceCode) {
+      return call("/auth/device/poll", { method: "POST", body: { deviceCode } });
+    },
+
+    /** GET /projects */
+    listProjects() {
+      return call("/projects");
+    },
+
+    /** GET /projects/:id */
+    getProject(id) {
+      return call(`/projects/${encodeURIComponent(id)}`);
+    },
+
+    /** GET /projects/:id/files */
+    listFiles(id) {
+      return call(`/projects/${encodeURIComponent(id)}/files`);
+    },
+
+    /** GET /projects/:id/files/content?path= */
+    getContent(id, filePath) {
+      const qs = new URLSearchParams({ path: filePath }).toString();
+      return call(`/projects/${encodeURIComponent(id)}/files/content?${qs}`);
+    },
+
+    /** PUT /projects/:id/files — { path, content, editNote } */
+    putFile(id, { path: filePath, content, editNote }) {
+      return call(`/projects/${encodeURIComponent(id)}/files`, {
+        method: "PUT",
+        body: { path: filePath, content, editNote },
+      });
+    },
+
+    /** DELETE /projects/:id/files?path= */
+    deleteFile(id, filePath) {
+      const qs = new URLSearchParams({ path: filePath }).toString();
+      return call(`/projects/${encodeURIComponent(id)}/files?${qs}`, {
+        method: "DELETE",
+      });
+    },
+
+    /** POST /projects/:id/export/html */
+    exportHtml(id) {
+      return call(`/projects/${encodeURIComponent(id)}/export/html`, {
+        method: "POST",
+      });
+    },
+
+    /** POST /projects/:id/export/react */
+    exportReact(id) {
+      return call(`/projects/${encodeURIComponent(id)}/export/react`, {
+        method: "POST",
+      });
+    },
+
+    /** GET /projects/:id/export/versions — poll trạng thái build */
+    pollExport(id) {
+      return call(`/projects/${encodeURIComponent(id)}/export/versions`);
+    },
+
+    /**
+     * Tải file nhị phân (vd export/versions/:vid/download) — trả Buffer.
+     * `url` có thể là path tương đối (nối base) hoặc URL tuyệt đối.
+     */
+    async download(downloadUrl) {
+      const target = /^https?:\/\//i.test(downloadUrl)
+        ? downloadUrl
+        : `${base}${downloadUrl}`;
+      const headers = token ? { Authorization: `Bearer ${token}` } : {};
+      let res;
+      try {
+        res = await fetch(target, { headers });
+      } catch (err) {
+        throw new ApiError(`Không tải được file (${target}): ${err.message}`, {
+          status: 0,
+        });
+      }
+      if (!res.ok) {
+        throw new ApiError(messageForStatus(res.status, `HTTP ${res.status}`), {
+          status: res.status,
+        });
+      }
+      const arrayBuffer = await res.arrayBuffer();
+      return Buffer.from(arrayBuffer);
+    },
+  };
+}
+
+module.exports = {
+  ApiError,
+  createApiClient,
+};

package/lib/ui/clone.js

@@ -0,0 +1,115 @@
+// lib/ui/clone.js — chọn dự án trên Pan Studio, tải cây file về local, ghi backend.id
+// vào app.panui.yaml (§4.4). Không tự xóa thư mục đích nếu đã tồn tại.
+const fs = require("fs");
+const path = require("path");
+const { createApiClient } = require("./api");
+const { getApiConfig, loadCredential, isExpired } = require("./config");
+const { findWorkspaceRoot, writeBackendId } = require("./workspace");
+const { menuSelect } = require("../menu-prompt");
+const { t } = require("../i18n");
+
+async function loadInquirer() {
+  const inq = await import("@inquirer/prompts").catch(() => null);
+  if (!inq) {
+    throw new Error("Cần TTY (@inquirer/prompts) cho lệnh này.");
+  }
+  return inq;
+}
+
+function toList(res) {
+  if (Array.isArray(res)) return res;
+  if (res && Array.isArray(res.items)) return res.items;
+  if (res && Array.isArray(res.data)) return res.data;
+  return [];
+}
+
+async function run(_args) {
+  const workspaceRoot = findWorkspaceRoot() || process.cwd();
+  const { apiUrl } = getApiConfig(workspaceRoot);
+  const cred = loadCredential(apiUrl);
+  if (!cred || isExpired(cred)) {
+    throw new Error("Chưa đăng nhập hoặc key đã hết hạn — chạy `pan ui init` trước.");
+  }
+  const api = createApiClient({ apiUrl, token: cred.token });
+
+  const projectsRes = await api.listProjects();
+  const list = toList(projectsRes);
+  if (!list.length) {
+    console.log("Chưa có dự án nào trên Pan Studio — tạo dự án trước khi clone.");
+    return;
+  }
+
+  const message = "Chọn dự án để clone:";
+  const choices = list.map((p) => ({
+    name: `${p.name || p.id}  (${p.id})`,
+    value: p.id,
+  }));
+  const hotkeys = [{ key: "x", label: t("EXIT_LABEL"), value: "__exit__" }];
+
+  let projectId;
+  try {
+    projectId = await menuSelect({ message, choices, hotkeys });
+  } catch (err) {
+    if (String(err && err.message) !== "no-core") throw err;
+    const inq = await loadInquirer();
+    projectId = await inq.select({
+      message,
+      choices: [...choices, new inq.Separator(), { name: `x  ${t("EXIT_LABEL")}`, value: "__exit__" }],
+      loop: false,
+    });
+  }
+  if (projectId === "__exit__") {
+    console.log(t("EXITED"));
+    process.exit(0);
+  }
+  const project = list.find((p) => p.id === projectId) || { id: projectId };
+
+  // BUGFIX (2026-07-23): `inq` chỉ được gán trong nhánh catch (fallback khi menuSelect lỗi
+  // "no-core") — khi menuSelect (hệ thống menu mới) chạy THÀNH CÔNG, `inq` chưa từng tồn tại
+  // → "inq is not defined" ở bước nhập thư mục đích. Tự nạp riêng, không phụ thuộc nhánh trên.
+  const inqInput = await loadInquirer();
+  const targetInput = await inqInput.input({
+    message: "Thư mục đích để clone (vd: pan-ui, ./design/landing, /abs/path):",
+    default: "pan-ui",
+  });
+  const targetDir = path.isAbsolute(targetInput)
+    ? targetInput
+    : path.resolve(process.cwd(), targetInput);
+
+  if (fs.existsSync(targetDir)) {
+    throw new Error(`Thư mục đã tồn tại: ${targetDir} — xóa thủ công rồi thử lại.`);
+  }
+
+  console.log(`Tải dự án '${project.name || project.id}' về ${targetDir} ...`);
+  const treeRes = await api.listFiles(projectId);
+  const files = toList(treeRes);
+
+  fs.mkdirSync(targetDir, { recursive: true });
+  let count = 0;
+  for (const f of files) {
+    if (f.fileType === "directory" || f.fileType === "dir") {
+      continue;
+    }
+    const filePath = f.filePath || f.path;
+    if (!filePath) continue;
+    const contentRes = await api.getContent(projectId, filePath);
+    const content =
+      typeof contentRes === "string" ? contentRes : contentRes && contentRes.content;
+    const dest = path.join(targetDir, filePath);
+    fs.mkdirSync(path.dirname(dest), { recursive: true });
+    fs.writeFileSync(dest, content ?? "", "utf8");
+    console.log(`  + ${filePath}`);
+    count += 1;
+  }
+
+  const appYamlPath = path.join(targetDir, "app.panui.yaml");
+  if (!fs.existsSync(appYamlPath)) {
+    fs.mkdirSync(path.dirname(appYamlPath), { recursive: true });
+    fs.writeFileSync(appYamlPath, "", "utf8");
+  }
+  writeBackendId(appYamlPath, { id: projectId, apiUrl });
+
+  console.log(`Đã clone ${count} file vào: ${targetDir}`);
+}
+
+module.exports = { run };