pan-stack-cli 0.2.1 → 0.2.3

package/lib/create.js

@@ -1,105 +0,0 @@
-const fs = require("fs");
-const os = require("os");
-const path = require("path");
-const readline = require("readline");
-const { validateFolderName } = require("./platform");
-const { getRegistryBaseUrl, fetchRegistry, downloadAndExtract } = require("./skill-registry-client");
-
-const TEMPLATE_NAME = "workspace";
-
-function promptFolderName() {
-  return new Promise((resolve, reject) => {
-    if (!process.stdin.isTTY) {
-      reject(new Error("Folder name required: pan create <folder-name>"));
-      return;
-    }
-
-    const rl = readline.createInterface({
-      input: process.stdin,
-      output: process.stdout,
-    });
-
-    rl.question("Workspace folder name: ", (answer) => {
-      rl.close();
-      const name = answer.trim();
-      if (!name) {
-        reject(new Error("Folder name cannot be empty."));
-        return;
-      }
-      resolve(name);
-    });
-  });
-}
-
-function copyDir(src, dest) {
-  fs.mkdirSync(dest, { recursive: true });
-  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
-    if (entry.name === "template.json") continue; // metadata riêng cho registry, không phải file scaffold
-    const srcPath = path.join(src, entry.name);
-    const destPath = path.join(dest, entry.name);
-    if (entry.isDirectory()) {
-      copyDir(srcPath, destPath);
-    } else {
-      fs.copyFileSync(srcPath, destPath);
-    }
-  }
-}
-
-function applyPlaceholders(targetDir, folderName) {
-  const files = [".project.yaml", "README.md"];
-  for (const relativePath of files) {
-    const filePath = path.join(targetDir, relativePath);
-    if (!fs.existsSync(filePath)) {
-      continue;
-    }
-    const content = fs.readFileSync(filePath, "utf8");
-    fs.writeFileSync(filePath, content.replaceAll("__PROJECT_NAME__", folderName));
-  }
-}
-
-async function runCreate(args = []) {
-  let folderName = args[0]?.trim();
-  if (!folderName) {
-    folderName = await promptFolderName();
-  }
-
-  validateFolderName(folderName);
-
-  const targetDir = path.resolve(process.cwd(), folderName);
-  if (fs.existsSync(targetDir)) {
-    throw new Error(`Folder already exists: ${targetDir}`);
-  }
-
-  // Template scaffold không còn bundle sẵn trong pan-stack-cli — tải từ registry server (giống
-  // cơ chế `pan ai install`). Cần PAN_SKILL_REGISTRY_URL (hoặc default localhost:4600) chạy được.
-  const baseUrl = getRegistryBaseUrl();
-  const items = await fetchRegistry(baseUrl);
-  const template = items.find((i) => i.type === "template" && i.name === TEMPLATE_NAME);
-  if (!template) {
-    throw new Error(
-      `Không tìm thấy template '${TEMPLATE_NAME}' trên registry server (${baseUrl}). Kiểm tra apps/pan-agent-skill-registry đã build/deploy đủ registry/templates/${TEMPLATE_NAME} chưa.`
-    );
-  }
-
-  const stagingDir = fs.mkdtempSync(path.join(os.tmpdir(), "pan-create-"));
-  let extractedDir;
-  try {
-    extractedDir = await downloadAndExtract(baseUrl, template, stagingDir);
-    copyDir(extractedDir, targetDir);
-  } finally {
-    fs.rmSync(stagingDir, { recursive: true, force: true });
-  }
-
-  applyPlaceholders(targetDir, folderName);
-
-  console.log(`Created PAN Stack workspace: ${targetDir}`);
-  console.log("");
-  console.log("Next steps:");
-  console.log(`  cd ${folderName}`);
-  console.log("  # Edit .project.yaml with your repository URLs");
-  console.log("  pan clone");
-}
-
-module.exports = {
-  runCreate,
-};

package/lib/discover.js

@@ -1,294 +0,0 @@
-const fs = require("fs");
-const path = require("path");
-const os = require("os");
-const { splitEnvList } = require("./platform");
-const {
-  PAN_CONFIG_FILE,
-  loadManifest,
-  loadPanConfig,
-  getCommandDefinition,
-  commandAliases,
-  validateRepo,
-  cleanValue,
-} = require("./manifest");
-
-const BUILTIN_GIT_COMMANDS = new Set([
-  "clone",
-  "pull",
-  "sync-main",
-  "sm",
-  "fetch",
-  "gfa",
-  "push",
-  "grv",
-  "gst",
-  "mr",
-  "checkout",
-  "co",
-]);
-const BUILTIN_WORKSPACE_COMMANDS = new Set([
-  "create",
-  "serve",
-  "language",
-  "lang",
-  "ai",
-  "skills",
-  "ui",
-  "stats",
-  "graph",
-  "git",
-  ...BUILTIN_GIT_COMMANDS,
-]);
-
-function readProjectRoots() {
-  const roots = [];
-  const fromEnv = process.env.PAN_PROJECT_ROOTS || "";
-  for (const part of splitEnvList(fromEnv)) {
-    roots.push(path.resolve(part));
-  }
-
-  const registry = path.join(os.homedir(), ".pan", "projects");
-  if (fs.existsSync(registry)) {
-    const content = fs.readFileSync(registry, "utf8");
-    for (const line of content.split(/\r?\n/)) {
-      const trimmed = line.trim();
-      if (!trimmed || trimmed.startsWith("#")) {
-        continue;
-      }
-      roots.push(path.resolve(trimmed));
-    }
-  }
-
-  return [...new Set(roots)];
-}
-
-function manifestPathInDir(dir) {
-  const candidate = path.join(dir, ".project.yaml");
-  return fs.existsSync(candidate) ? candidate : null;
-}
-
-function walkUpManifests(startDir) {
-  const found = [];
-  let current = path.resolve(startDir);
-  const seen = new Set();
-
-  while (true) {
-    const manifestPath = manifestPathInDir(current);
-    if (manifestPath && !seen.has(manifestPath)) {
-      seen.add(manifestPath);
-      found.push(manifestPath);
-    }
-    const parent = path.dirname(current);
-    if (parent === current) {
-      break;
-    }
-    current = parent;
-  }
-
-  return found;
-}
-
-function findNearestProjectManifest(startDir = process.cwd()) {
-  const walked = walkUpManifests(startDir);
-  return walked[0] || null;
-}
-
-const DISCOVER_SKIP_DIRS = new Set([
-  ".git", "node_modules", ".pnpm", "dist", "build", ".next", "target", "vendor",
-]);
-
-/**
- * Fallback khi không có .project.yaml: quét git repo từ CHÍNH thư mục đang gõ
- * lệnh (startDir) xuống tối đa `maxDepth` cấp — bao gồm chính startDir, thư mục
- * con trực tiếp, và các cấp con tiếp theo (đủ bắt submodule). Dùng chung cho
- * `pan stats` và các lệnh git built-in (`pan pull|push|fetch|checkout|...`) khi
- * chạy ngoài workspace pan-stack (không có `.project.yaml`).
- * @returns {Array<{name,dir}>}
- */
-function discoverGitRepos(startDir = process.cwd(), maxDepth = 2) {
-  const base = path.resolve(startDir);
-  const found = [];
-  const seen = new Set();
-
-  function walk(dir, depth) {
-    if (depth > maxDepth) return;
-    let entries;
-    try {
-      entries = fs.readdirSync(dir, { withFileTypes: true });
-    } catch {
-      return;
-    }
-    if (entries.some((e) => e.name === ".git")) {
-      const abs = path.resolve(dir);
-      if (!seen.has(abs)) {
-        seen.add(abs);
-        found.push({ name: path.basename(abs), dir: abs });
-      }
-    }
-    for (const e of entries) {
-      if (e.isDirectory() && !DISCOVER_SKIP_DIRS.has(e.name)) walk(path.join(dir, e.name), depth + 1);
-    }
-  }
-
-  walk(base, 0);
-  return found.sort((a, b) => a.name.localeCompare(b.name));
-}
-
-function findNearestWorkspace(startDir = process.cwd()) {
-  const manifestPath = findNearestProjectManifest(startDir);
-  if (!manifestPath) {
-    return null;
-  }
-  return loadManifest(manifestPath);
-}
-
-function loadCommandSourcesForWorkspace(workspace) {
-  const sources = [];
-  const workspaceRoot = workspace.root;
-  const workspacePan = path.join(workspaceRoot, PAN_CONFIG_FILE);
-
-  if (fs.existsSync(workspacePan)) {
-    sources.push(
-      loadPanConfig(workspacePan, {
-        workspaceRoot,
-        project: workspace.project,
-        repoName: workspace.project,
-        scope: "workspace",
-      })
-    );
-  }
-
-  for (const repo of workspace.repositories) {
-    try {
-      const { name, repoPath } = validateRepo(repo);
-      const repoDir = path.resolve(workspaceRoot, repoPath);
-      const repoPan = path.join(repoDir, PAN_CONFIG_FILE);
-      if (!fs.existsSync(repoPan)) {
-        continue;
-      }
-      sources.push(
-        loadPanConfig(repoPan, {
-          workspaceRoot,
-          project: name,
-          repoName: name,
-          scope: "repo",
-        })
-      );
-    } catch {
-      // skip invalid repo entries
-    }
-  }
-
-  return sources;
-}
-
-function collectWorkspaces(startDir = process.cwd()) {
-  const workspaces = new Map();
-
-  for (const manifestPath of walkUpManifests(startDir)) {
-    try {
-      const workspace = loadManifest(manifestPath);
-      workspaces.set(workspace.root, workspace);
-    } catch {
-      // ignore
-    }
-  }
-
-  for (const root of readProjectRoots()) {
-    const manifestPath = manifestPathInDir(root);
-    if (!manifestPath) {
-      continue;
-    }
-    try {
-      const workspace = loadManifest(manifestPath);
-      workspaces.set(workspace.root, workspace);
-    } catch {
-      // ignore
-    }
-  }
-
-  return [...workspaces.values()];
-}
-
-function loadAllCommandSources(startDir = process.cwd()) {
-  const sources = [];
-  const seen = new Set();
-
-  for (const workspace of collectWorkspaces(startDir)) {
-    for (const source of loadCommandSourcesForWorkspace(workspace)) {
-      const key = source.path;
-      if (seen.has(key)) {
-        continue;
-      }
-      seen.add(key);
-      sources.push(source);
-    }
-  }
-
-  return sources;
-}
-
-function sourceMatchesProject(source, projectFlag) {
-  const flag = projectFlag.trim();
-  return (
-    source.project === flag ||
-    source.repoName === flag ||
-    path.basename(source.root) === flag
-  );
-}
-
-function sourceHasCommand(source, commandName) {
-  if (source.commands[commandName]) {
-    return true;
-  }
-  return Object.values(source.commands || {}).some((def) =>
-    commandAliases(def).includes(commandName)
-  );
-}
-
-function findSourcesWithCommand(commandName, startDir = process.cwd()) {
-  return loadAllCommandSources(startDir).filter((source) =>
-    sourceHasCommand(source, commandName)
-  );
-}
-
-function formatProjectList(matches, commandName) {
-  const lines = [`Command '${commandName}' is defined in multiple places:`];
-  matches.forEach((source, index) => {
-    const def = source.commands[commandName];
-    const desc = def?.description ? ` — ${def.description}` : "";
-    const label =
-      source.scope === "workspace"
-        ? `${source.project} (workspace)`
-        : source.repoName || source.project;
-    lines.push(`  ${index + 1}. ${label} (${source.root})${desc}`);
-  });
-  lines.push("");
-  lines.push("Pick a number, or rerun with --project <repo-name>.");
-  return lines.join("\n");
-}
-
-function isBuiltinGitCommand(name) {
-  return BUILTIN_GIT_COMMANDS.has(name);
-}
-
-function isBuiltinWorkspaceCommand(name) {
-  return BUILTIN_WORKSPACE_COMMANDS.has(name);
-}
-
-module.exports = {
-  BUILTIN_GIT_COMMANDS,
-  BUILTIN_WORKSPACE_COMMANDS,
-  PAN_CONFIG_FILE,
-  findNearestProjectManifest,
-  findNearestWorkspace,
-  discoverGitRepos,
-  loadAllCommandSources,
-  loadCommandSourcesForWorkspace,
-  findSourcesWithCommand,
-  formatProjectList,
-  isBuiltinGitCommand,
-  isBuiltinWorkspaceCommand,
-  getCommandDefinition,
-  sourceMatchesProject,
-};