pan-stack-cli 0.2.1 → 0.2.3

package/lib/skill-registry-client.js

@@ -1,173 +0,0 @@
-// Client cho registry server pan-agent-skill-registry (apps/pan-agent-skill-registry):
-// gọi HTTP /api/registry + /api/packages/*.zip, quản lý lockfile local
-// <workspaceRoot>/.pan/skills-lock.json để biết cái gì đã cài (installed vs updatable).
-const fs = require("fs");
-const os = require("os");
-const path = require("path");
-const { execFileSync } = require("child_process");
-const { isWindows } = require("./platform");
-
-const DEFAULT_REGISTRY_URL = "http://localhost:4600";
-const LOCK_RELATIVE_PATH = path.join(".pan", "skills-lock.json");
-
-function getRegistryBaseUrl() {
-  return (process.env.PAN_SKILL_REGISTRY_URL || DEFAULT_REGISTRY_URL).replace(/\/+$/, "");
-}
-
-function friendlyNetworkError(baseUrl, err) {
-  return new Error(
-    `✗ Không kết nối được tới registry server (${baseUrl}). Cần server đang chạy trước — xem apps/pan-agent-skill-registry/README.md.` +
-      (err && err.message ? ` (${err.message})` : "")
-  );
-}
-
-async function fetchJson(url) {
-  let res;
-  try {
-    res = await fetch(url);
-  } catch (err) {
-    throw friendlyNetworkError(url, err);
-  }
-  if (!res.ok) {
-    throw new Error(`✗ Registry server trả lỗi HTTP ${res.status} cho ${url}`);
-  }
-  return res.json();
-}
-
-async function fetchRegistry(baseUrl = getRegistryBaseUrl()) {
-  const data = await fetchJson(`${baseUrl}/api/registry`);
-  return Array.isArray(data.items) ? data.items : [];
-}
-
-async function checkHealth(baseUrl = getRegistryBaseUrl()) {
-  try {
-    const data = await fetchJson(`${baseUrl}/health`);
-    return !!(data && data.ok);
-  } catch {
-    return false;
-  }
-}
-
-function lockPath(workspaceRoot) {
-  return path.join(workspaceRoot, LOCK_RELATIVE_PATH);
-}
-
-function loadLock(workspaceRoot) {
-  const p = lockPath(workspaceRoot);
-  if (!fs.existsSync(p)) {
-    return { installed: {} };
-  }
-  try {
-    const raw = JSON.parse(fs.readFileSync(p, "utf8"));
-    if (!raw || typeof raw !== "object") return { installed: {} };
-    if (!raw.installed || typeof raw.installed !== "object") raw.installed = {};
-    return raw;
-  } catch {
-    return { installed: {} };
-  }
-}
-
-function saveLock(workspaceRoot, lock) {
-  const dir = path.join(workspaceRoot, ".pan");
-  if (!fs.existsSync(dir)) {
-    fs.mkdirSync(dir, { recursive: true });
-  }
-  fs.writeFileSync(lockPath(workspaceRoot), JSON.stringify(lock, null, 2) + "\n", "utf8");
-}
-
-// @returns { notInstalled: item[], updatable: item[], upToDate: item[] }
-// (updatable/upToDate item objects are augmented with `oldVersion`).
-function diffRegistry(items, lock) {
-  const installed = (lock && lock.installed) || {};
-  const notInstalled = [];
-  const updatable = [];
-  const upToDate = [];
-  for (const item of items) {
-    const entry = installed[item.name];
-    if (!entry) {
-      notInstalled.push(item);
-    } else if (entry.version !== item.version) {
-      updatable.push({ ...item, oldVersion: entry.version });
-    } else {
-      upToDate.push(item);
-    }
-  }
-  return { notInstalled, updatable, upToDate };
-}
-
-function downloadToTemp(url) {
-  return new Promise((resolve, reject) => {
-    fetch(url)
-      .then(async (res) => {
-        if (!res.ok) {
-          reject(new Error(`✗ Tải zip thất bại (HTTP ${res.status}) từ ${url}`));
-          return;
-        }
-        const buf = Buffer.from(await res.arrayBuffer());
-        const tmpFile = path.join(os.tmpdir(), `pan-skill-${Date.now()}-${Math.random().toString(36).slice(2)}.zip`);
-        fs.writeFileSync(tmpFile, buf);
-        resolve(tmpFile);
-      })
-      .catch((err) => reject(friendlyNetworkError(url, err)));
-  });
-}
-
-function extractZip(zipFile, destDir) {
-  if (fs.existsSync(destDir)) {
-    fs.rmSync(destDir, { recursive: true, force: true });
-  }
-  fs.mkdirSync(destDir, { recursive: true });
-
-  if (isWindows()) {
-    try {
-      execFileSync(
-        "powershell",
-        ["-NoProfile", "-Command", `Expand-Archive -Force -Path '${zipFile}' -DestinationPath '${destDir}'`],
-        { stdio: "pipe" }
-      );
-      return;
-    } catch (err) {
-      throw new Error(
-        `✗ Không giải nén được (PowerShell Expand-Archive). Cần PowerShell khả dụng trên máy. (${err.message})`
-      );
-    }
-  }
-
-  try {
-    execFileSync("unzip", ["-o", "-q", zipFile, "-d", destDir], { stdio: "pipe" });
-  } catch (err) {
-    throw new Error(
-      `✗ Không giải nén được (thiếu lệnh 'unzip' hoặc file zip lỗi). Cài unzip rồi thử lại. (${err.message})`
-    );
-  }
-}
-
-// Tải zip của `item` (từ baseUrl + item.zip) và giải nén vào `<destDir>/<item.name>/`
-// (zip không có lớp thư mục bọc — ta tự tạo).
-async function downloadAndExtract(baseUrl, item, destDir) {
-  const zipUrl = `${baseUrl}${item.zip}`;
-  const tmpFile = await downloadToTemp(zipUrl);
-  try {
-    const target = path.join(destDir, item.name);
-    extractZip(tmpFile, target);
-    return target;
-  } finally {
-    try {
-      fs.unlinkSync(tmpFile);
-    } catch {
-      /* bỏ qua */
-    }
-  }
-}
-
-module.exports = {
-  DEFAULT_REGISTRY_URL,
-  getRegistryBaseUrl,
-  fetchRegistry,
-  checkHealth,
-  lockPath,
-  loadLock,
-  saveLock,
-  diffRegistry,
-  downloadAndExtract,
-};

package/lib/stats/aggregate.js

@@ -1,51 +0,0 @@
-"use strict";
-
-const { canonicalEmail } = require("./identity");
-
-/**
- * Gộp commit theo thành viên (email chuẩn) và theo dự án.
- * (Commit đã được lọc theo range ở tầng git; range ở đây chỉ để chắc chắn.)
- */
-function aggregate(commits, aliasMap = {}, range = {}) {
-  const { from = -Infinity, to = Infinity } = range;
-  const byEmail = new Map();
-
-  for (const c of commits) {
-    if (c.ts < from || c.ts > to) continue;
-    const email = canonicalEmail(c.email, aliasMap);
-    if (!byEmail.has(email)) {
-      byEmail.set(email, { email, name: c.name || email, commits: 0, additions: 0, deletions: 0, projects: new Map() });
-    }
-    const m = byEmail.get(email);
-    m.commits += 1;
-    m.additions += c.additions;
-    m.deletions += c.deletions;
-    if (c.name) m.name = c.name;
-
-    if (!m.projects.has(c.repoName)) {
-      m.projects.set(c.repoName, { name: c.repoName, commits: 0, additions: 0, deletions: 0 });
-    }
-    const p = m.projects.get(c.repoName);
-    p.commits += 1;
-    p.additions += c.additions;
-    p.deletions += c.deletions;
-  }
-
-  const members = [...byEmail.values()]
-    .map((m) => ({ ...m, projects: [...m.projects.values()].sort((a, b) => b.commits - a.commits) }))
-    .sort((a, b) => b.commits - a.commits);
-
-  const totals = members.reduce(
-    (acc, m) => {
-      acc.commits += m.commits;
-      acc.additions += m.additions;
-      acc.deletions += m.deletions;
-      return acc;
-    },
-    { members: members.length, commits: 0, additions: 0, deletions: 0 }
-  );
-
-  return { members, totals };
-}
-
-module.exports = { aggregate };

package/lib/stats/identity.js

@@ -1,20 +0,0 @@
-"use strict";
-
-const fs = require("fs");
-
-/** Đọc alias-map.json (email biến thể -> email chuẩn). Không có thì {}. */
-function loadAliasMap(file) {
-  try {
-    return JSON.parse(fs.readFileSync(file, "utf8"));
-  } catch {
-    return {};
-  }
-}
-
-/** Chuẩn hoá email theo alias-map (fallback chính nó). */
-function canonicalEmail(email, aliasMap = {}) {
-  const key = (email || "").toLowerCase().trim();
-  return aliasMap[key] || key || "unknown@local";
-}
-
-module.exports = { loadAliasMap, canonicalEmail };

package/lib/stats/index.js

@@ -1,189 +0,0 @@
-"use strict";
-
-const fs = require("fs");
-const path = require("path");
-const os = require("os");
-const { findNearestWorkspace } = require("../discover");
-const { reposFromWorkspace, discoverGitRepos, scanAll } = require("./scan");
-const { resolveRange } = require("./range");
-const { loadAliasMap, canonicalEmail } = require("./identity");
-const { aggregate } = require("./aggregate");
-const { buildReport } = require("./report");
-const { serveHtml } = require("./serve");
-const { buildReviewMarkdown, writeReview } = require("./review");
-
-function parseArgs(argv) {
-  const o = { _: [], open: true, diff: true };
-  for (let i = 0; i < argv.length; i++) {
-    const a = argv[i];
-    if (a === "--since") o.since = argv[++i];
-    else if (a === "--from") o.from = argv[++i];
-    else if (a === "--to") o.to = argv[++i];
-    else if (a === "--member" || a === "-m") o.member = argv[++i];
-    else if (a === "--project" || a === "-p") o.project = argv[++i];
-    else if (a === "--port") o.port = parseInt(argv[++i], 10);
-    else if (a === "--out" || a === "-o") o.out = argv[++i];
-    else if (a === "--no-open") o.open = false;
-    else if (a === "--no-diff") o.diff = false;
-    else if (a === "--head-only") o.headOnly = true;
-    else if (a === "--max-diff-lines") o.maxDiffLines = parseInt(argv[++i], 10);
-    else if (a.startsWith("--since=")) o.since = a.slice(8);
-    else o._.push(a);
-  }
-  return o;
-}
-
-function dataDir() {
-  const dir = path.join(os.homedir(), ".pan-code-graph");
-  fs.mkdirSync(dir, { recursive: true });
-  return dir;
-}
-
-/**
- * Nguồn repo để thống kê: ưu tiên .project.yaml; nếu không có thì fallback quét
- * git quanh pwd (thư mục cha + tối đa 2 cấp).
- * @returns {{repos:Array<{name,dir}>, source:string}}
- */
-function resolveRepos() {
-  const ws = findNearestWorkspace();
-  if (ws) return { repos: reposFromWorkspace(ws), source: `.project.yaml (${ws.project})` };
-
-  const repos = discoverGitRepos(process.cwd());
-  if (!repos.length) {
-    throw new Error(
-      `Không tìm thấy pan-stack .project.yaml, cũng không thấy git repo nào từ ${process.cwd()} (đã quét pwd + 2 cấp con).`
-    );
-  }
-  console.log(`ℹ️  Không tìm thấy pan-stack .project.yaml — fallback quét git từ ${process.cwd()} (pwd + 2 cấp con).`);
-  return { repos, source: "fallback (quét từ pwd)" };
-}
-
-function printHelp() {
-  console.log(`pan stats — thống kê đóng góp Git từ .project.yaml
-(không có .project.yaml → fallback quét git từ pwd xuống 2 cấp con)
-
-lệnh:
-  pan stats [report]          Quét & mở báo cáo HTML (mặc định)
-  pan stats people            Liệt kê thành viên tham gia
-  pan stats review            Xuất Markdown 1 thành viên × 1 dự án cho AI review
-
-lọc thời gian (dùng chung):
-  --since <n>                 Preset ngày: 1 2 3 4 5 7 14 30 (30 = 1 tháng)
-  --from <YYYY-MM-DD> --to <YYYY-MM-DD>   Khoảng ngày tuỳ chọn
-
-options:
-  -m, --member <email|tên>    Lọc theo thành viên (review: bắt buộc)
-  -p, --project <tên repo>    Lọc theo dự án (review: bắt buộc)
-      --port <n>              Cổng serve (mặc định 4321)
-      --no-open               Không tự mở trình duyệt
-  -o, --out <file>            Đường dẫn file xuất
-      --no-diff               (review) chỉ tóm tắt, không kèm diff
-      --max-diff-lines <n>    (review) giới hạn dòng diff (mặc định 6000)
-      --head-only             Chỉ quét HEAD hiện tại (mặc định: --all — mọi nhánh
-                              local + remote-tracking + tags). Nếu commit ở remote
-                              chưa thấy, chạy 'pan fetch' trước.
-
-ví dụ:
-  pan stats --since 7
-  pan stats report --from 2026-07-01 --to 2026-07-22
-  pan stats people
-  pan stats review -m an@fpt.com -p csdl-cc-backend --since 7 -o review.md
-`);
-}
-
-async function runStats(argv) {
-  const o = parseArgs(argv);
-  const sub = ["report", "people", "review"].includes(o._[0]) ? o._.shift() : "report";
-
-  if (o._[0] === "help" || o.help) return printHelp();
-
-  if (sub === "review") return runReview(o);
-  if (sub === "people") return runPeople(o);
-  return runReport(o);
-}
-
-function loadAndScan(o) {
-  const { repos } = resolveRepos();
-  const range = resolveRange(o);
-  const allBranches = !o.headOnly;
-  const scope = allBranches ? "mọi nhánh" : "chỉ HEAD";
-  console.log(`🔍 Quét ${repos.length} repo · ${scope} · ${range.label}:`);
-  const { commits, repoStatus } = scanAll(repos, range, { allBranches });
-  const aliasMap = loadAliasMap(path.join(dataDir(), "alias-map.json"));
-  return { repos, range, commits, repoStatus, aliasMap };
-}
-
-function runReport(o) {
-  // Quét TOÀN BỘ lịch sử để nhúng commit thô → bộ lọc thời gian chạy phía client.
-  const { repos } = resolveRepos();
-  const fullRange = resolveRange({});
-  const allBranches = !o.headOnly;
-  const scope = allBranches ? "mọi nhánh" : "chỉ HEAD";
-  console.log(`🔍 Quét ${repos.length} repo · ${scope} · toàn bộ (lọc thời gian trong report):`);
-  const { commits, repoStatus } = scanAll(repos, fullRange, { allBranches });
-  const aliasMap = loadAliasMap(path.join(dataDir(), "alias-map.json"));
-
-  // Commit thô, gọn: e=email chuẩn, n=tên, t=ts(giây), r=repo, a=add, d=del
-  const rawCommits = commits.map((c) => ({
-    e: canonicalEmail(c.email, aliasMap),
-    n: c.name || c.email,
-    t: c.ts,
-    r: c.repoName,
-    a: c.additions,
-    d: c.deletions,
-  }));
-
-  const unavailable = repoStatus.filter((r) => !r.available).map((r) => ({ name: r.name, reason: r.reason }));
-  const initial = resolveRange(o); // range khởi tạo từ CLI (mặc định: toàn bộ)
-  const meta = {
-    reposTotal: repoStatus.length,
-    reposAvailable: repoStatus.filter((r) => r.available).length,
-    unavailable,
-    initialSince: o.since != null ? Number(o.since) : null,
-    initialFrom: o.from || null,
-    initialTo: o.to || null,
-    initialMembers: o.member ? [o.member] : [],
-  };
-
-  const html = buildReport(rawCommits, meta);
-  const outFile = o.out || path.join(dataDir(), "report.html");
-  fs.writeFileSync(outFile, html);
-  console.log(`💾 Đã ghi ${outFile} (${rawCommits.length} commit)`);
-  if (unavailable.length) console.log(`⚠️  ${unavailable.length} repo không đọc được (đã ghi cảnh báo trong report).`);
-  serveHtml(html, { port: o.port || 4321, open: o.open });
-}
-
-function runPeople(o) {
-  const { commits, aliasMap } = loadAndScan(o);
-  const { members } = aggregate(commits, aliasMap);
-  console.log(`\n👥 ${members.length} thành viên tham gia:\n`);
-  for (const m of members) {
-    console.log(`  ${String(m.commits).padStart(5)} commit  ${m.name} <${m.email}>`);
-  }
-}
-
-function runReview(o) {
-  if (!o.member || !o.project) {
-    throw new Error("review cần --member <email|tên> và --project <tên repo>.");
-  }
-  const { repos } = resolveRepos();
-  const repo = repos.find((r) => r.name === o.project);
-  if (!repo) throw new Error(`Không có dự án '${o.project}' (repo khả dụng: ${repos.map((r) => r.name).join(", ")}).`);
-  if (!fs.existsSync(repo.dir)) throw new Error(`Dự án '${o.project}' chưa clone (${repo.dir}).`);
-
-  const range = resolveRange(o);
-  console.log(`📝 Tạo review: ${o.member} × ${o.project} (${range.label})`);
-  const md = buildReviewMarkdown(repo, o.member, range, {
-    withDiff: o.diff,
-    maxDiffLines: o.maxDiffLines,
-    allBranches: !o.headOnly,
-  });
-
-  const safe = `${o.project}_${o.member.replace(/[^a-z0-9]+/gi, "-")}`.toLowerCase();
-  const outFile = o.out || path.join(dataDir(), `review-${safe}.md`);
-  writeReview(outFile, md);
-  console.log(`✅ Đã ghi ${outFile}`);
-  console.log(`   → Mở file này và nhờ AI review/chấm điểm.`);
-}
-
-module.exports = { runStats };

package/lib/stats/parse.js

@@ -1,46 +0,0 @@
-"use strict";
-
-const US = "\x1f"; // Unit Separator — ranh giới field trong header
-const HEAD = "@@@"; // tiền tố dòng header commit
-
-// Header: @@@<hash>US<email>US<name>US<unixDate>US<subject>
-// Theo sau là các dòng numstat: "additions\tdeletions\tpath" (binary = "-").
-const PRETTY_FORMAT = `${HEAD}%H${US}%ae${US}%an${US}%ad${US}%s`;
-
-/**
- * Parse output thô của `git log --numstat` thành mảng commit.
- */
-function parseGitLog(raw) {
-  const commits = [];
-  let cur = null;
-
-  for (const line of raw.split("\n")) {
-    if (line.startsWith(HEAD)) {
-      if (cur) commits.push(cur);
-      const [hash, email, name, date, subject] = line.slice(HEAD.length).split(US);
-      cur = {
-        hash,
-        email: (email || "").toLowerCase().trim(),
-        name: (name || "").trim(),
-        ts: Number(date) || 0,
-        subject: subject || "",
-        additions: 0,
-        deletions: 0,
-        files: 0,
-      };
-      continue;
-    }
-    if (!cur || !line.trim()) continue;
-    const parts = line.split("\t");
-    if (parts.length < 3) continue;
-    const add = parts[0] === "-" ? 0 : parseInt(parts[0], 10) || 0;
-    const del = parts[1] === "-" ? 0 : parseInt(parts[1], 10) || 0;
-    cur.additions += add;
-    cur.deletions += del;
-    cur.files += 1;
-  }
-  if (cur) commits.push(cur);
-  return commits;
-}
-
-module.exports = { parseGitLog, PRETTY_FORMAT, US, HEAD };

package/lib/stats/range.js

@@ -1,38 +0,0 @@
-"use strict";
-
-const PRESET_DAYS = new Set([1, 2, 3, 4, 5, 7, 14, 30]);
-
-/**
- * Chuẩn hoá khoảng thời gian từ options.
- * --since <n> (preset ngày) HOẶC --from/--to (YYYY-MM-DD). Không có → toàn bộ.
- * @returns {{from:number,to:number,label:string}} unix giây
- */
-function resolveRange({ since, from, to } = {}) {
-  const nowSec = Math.floor(Date.now() / 1000);
-
-  if (from || to) {
-    const fromSec = from ? Math.floor(Date.parse(from + "T00:00:00") / 1000) : -Infinity;
-    const toSec = to ? Math.floor(Date.parse(to + "T23:59:59") / 1000) : nowSec;
-    const label = `${from || "…"} → ${to || "nay"}`;
-    return { from: fromSec, to: toSec, label };
-  }
-
-  if (since != null && since !== "") {
-    const n = Number(since);
-    if (!Number.isFinite(n) || n <= 0) {
-      throw new Error(`--since không hợp lệ: ${since} (dùng 1 2 3 4 5 7 14 30)`);
-    }
-    const label = n === 30 ? "1 tháng gần đây" : `${n} ngày gần đây`;
-    return { from: nowSec - n * 86400, to: nowSec, label };
-  }
-
-  return { from: -Infinity, to: Infinity, label: "Toàn bộ lịch sử" };
-}
-
-/** ISO date (giây) cho git --since/--until; -Infinity/Infinity → null. */
-function toGitDate(sec) {
-  if (!Number.isFinite(sec)) return null;
-  return new Date(sec * 1000).toISOString();
-}
-
-module.exports = { resolveRange, toGitDate, PRESET_DAYS };