pan-stack-cli 0.1.5 → 0.2.2

package/package.json

@@ -1,19 +1,30 @@
 {
   "name": "pan-stack-cli",
-  "version": "0.1.5",
+  "version": "0.2.2",
   "description": "PAN Stack CLI — multi-repo git and project commands from .project.yaml",
   "license": "MIT",
   "bin": {
     "pan": "bin/pan.js"
   },
   "files": [
-    "bin",
-    "lib",
-    "templates"
+    "bin"
   ],
+  "scripts": {
+    "build": "node tools/pan-stack-cli/build.mjs",
+    "prepare": "node tools/pan-stack-cli/build.mjs",
+    "prepublishOnly": "node tools/pan-stack-cli/build.mjs",
+    "test": "node --test tools/pan-stack-plan/test/ tools/pan-stack-cli/test/",
+    "test:pan-stack-plan": "node --test tools/pan-stack-plan/test/",
+    "test:pan-stack-cli": "node --test tools/pan-stack-cli/test/"
+  },
   "engines": {
     "node": ">=18"
   },
+  "dependencies": {
+    "@inquirer/core": "^11.2.1",
+    "@inquirer/prompts": "^8.5.2",
+    "serve": "^14.2.4"
+  },
   "keywords": [
     "pan-stack",
     "monorepo",
@@ -24,5 +35,13 @@
     "type": "git",
     "url": "https://github.com/doiya46/pan-stack.git",
     "directory": ".pan/pan-stack-cli"
+  },
+  "devDependencies": {
+    "@inquirer/testing": "^3.3.9",
+    "csv-parse": "7.0.1",
+    "csv-stringify": "6.8.1",
+    "esbuild": "0.28.1",
+    "marked": "15.0.12",
+    "sanitize-html": "2.16.0"
   }
-}
+}

package/lib/create.js

@@ -1,87 +0,0 @@
-const fs = require("fs");
-const path = require("path");
-const readline = require("readline");
-const { validateFolderName } = require("./platform");
-
-const TEMPLATE_ROOT = path.join(__dirname, "..", "templates", "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 })) {
-    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}`);
-  }
-
-  if (!fs.existsSync(TEMPLATE_ROOT)) {
-    throw new Error(`Template not found: ${TEMPLATE_ROOT}`);
-  }
-
-  copyDir(TEMPLATE_ROOT, targetDir);
-  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,236 +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",
-  "push",
-  "grv",
-  "gst",
-]);
-const BUILTIN_WORKSPACE_COMMANDS = new Set(["create", ...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;
-}
-
-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,
-  loadAllCommandSources,
-  loadCommandSourcesForWorkspace,
-  findSourcesWithCommand,
-  formatProjectList,
-  isBuiltinGitCommand,
-  isBuiltinWorkspaceCommand,
-  getCommandDefinition,
-  sourceMatchesProject,
-};

package/lib/git/git-clone.js

@@ -1,71 +0,0 @@
-#!/usr/bin/env node
-/*
- * Clone PAN Stack project repositories from a small clone manifest.
- *
- * The parser intentionally supports only the manifest shape documented in
- * PAN_STACK.md. It avoids external dependencies so the script can run anywhere
- * Node.js and Git are available.
- */
-
-const fs = require("fs");
-const path = require("path");
-const { spawnSync } = require("child_process");
-const { spawnOptions } = require("../platform");
-const { parseCommonArgs, loadManifestRepos, printCommonOptions } = require("./helpers/cli");
-
-function cloneRepo({ name, url, destination, dryRun }) {
-  if (fs.existsSync(destination)) {
-    console.log(`[skip] ${name}: ${destination} already exists`);
-    return;
-  }
-
-  fs.mkdirSync(path.dirname(destination), { recursive: true });
-  const command = ["git", "clone", url, destination];
-  if (dryRun) {
-    console.log(`[dry-run] ${command.join(" ")}`);
-    return;
-  }
-
-  console.log(`[clone] ${name}: ${url} -> ${destination}`);
-  const result = spawnSync(command[0], command.slice(1), spawnOptions({ stdio: "inherit" }));
-  if (result.status !== 0) {
-    console.log(`[warn] ${name}: clone failed, check repo access or url`);
-  }
-}
-
-function printHelp() {
-  console.log(`usage: git-clone.js [--base-dir BASE_DIR] [--dry-run] [manifest]
-
-Clone repositories from a PAN Stack clone manifest.
-
-${printCommonOptions()}`);
-}
-
-function main() {
-  const args = parseCommonArgs(process.argv.slice(2));
-  if (args.help) {
-    printHelp();
-    return;
-  }
-
-  const { repos } = loadManifestRepos({
-    manifestPath: args.manifest,
-    baseDir: args.baseDir,
-  });
-
-  for (const repo of repos) {
-    cloneRepo({
-      name: repo.name,
-      url: repo.url,
-      destination: repo.destination,
-      dryRun: args.dryRun,
-    });
-  }
-}
-
-try {
-  main();
-} catch (error) {
-  console.error(error.message);
-  process.exit(1);
-}

package/lib/git/git-fetch-all.js

@@ -1,62 +0,0 @@
-#!/usr/bin/env node
-/*
- * Fetch all remotes for PAN Stack project repositories from a clone manifest.
- *
- * Skips repositories that do not exist or are not git checkouts. Failures warn
- * and continue so one broken repo does not block the rest.
- */
-
-const { parseCommonArgs, loadManifestRepos, printCommonOptions } = require("./helpers/cli");
-const { ensureRepoExists, runGit } = require("./helpers/git");
-
-function fetchRepo({ name, destination, dryRun }) {
-  if (!ensureRepoExists({ name, destination })) {
-    return;
-  }
-
-  const status = runGit(["fetch", "--all"], {
-    cwd: destination,
-    dryRun,
-    action: "fetch",
-    name,
-  });
-  if (status !== 0) {
-    console.log(`[warn] ${name}: fetch failed, check remote access`);
-  }
-}
-
-function printHelp() {
-  console.log(`usage: git-fetch-all.js [--base-dir BASE_DIR] [--dry-run] [manifest]
-
-Fetch all remotes for repositories listed in a PAN Stack clone manifest.
-
-${printCommonOptions()}`);
-}
-
-function main() {
-  const args = parseCommonArgs(process.argv.slice(2));
-  if (args.help) {
-    printHelp();
-    return;
-  }
-
-  const { repos } = loadManifestRepos({
-    manifestPath: args.manifest,
-    baseDir: args.baseDir,
-  });
-
-  for (const repo of repos) {
-    fetchRepo({
-      name: repo.name,
-      destination: repo.destination,
-      dryRun: args.dryRun,
-    });
-  }
-}
-
-try {
-  main();
-} catch (error) {
-  console.error(error.message);
-  process.exit(1);
-}

package/lib/git/git-grv.js

@@ -1,94 +0,0 @@
-#!/usr/bin/env node
-/*
- * List git remotes (git remote -v) for PAN Stack project repositories.
- *
- * oh-my-zsh-style alias for grv — full remote URLs (fetch/push).
- */
-
-const { parseCommonArgs, loadManifestRepos, printCommonOptions } = require("./helpers/cli");
-const { ensureRepoExists, isGitRepo, listRemotesVerbose } = require("./helpers/git");
-
-function printRepoRemotes({ label, destination, dryRun }) {
-  if (dryRun) {
-    console.log(`[dry-run] (in ${destination}) git remote -v`);
-    return;
-  }
-
-  console.log(`== ${label} ==`);
-  console.log(destination);
-  const lines = listRemotesVerbose(destination);
-  if (lines.length === 0) {
-    console.log("(no remotes)");
-  } else {
-    for (const line of lines) {
-      console.log(line);
-    }
-  }
-  console.log("");
-}
-
-function showWorkspaceRootRemotes({ workspaceRoot, dryRun }) {
-  if (!isGitRepo(workspaceRoot)) {
-    return;
-  }
-
-  printRepoRemotes({
-    label: "workspace",
-    destination: workspaceRoot,
-    dryRun,
-  });
-}
-
-function printHelp() {
-  console.log(`usage: git-grv.js [--base-dir BASE_DIR] [--dry-run] [--no-workspace] [manifest]
-
-List git remotes with full URLs (git remote -v) for each repository.
-
-${printCommonOptions()}
-  --no-workspace       Skip workspace root (manifest repos only)`);
-}
-
-function main() {
-  const args = parseCommonArgs(process.argv.slice(2), {
-    defaults: { noWorkspace: false },
-    handlers: {
-      "--no-workspace": (parsed) => {
-        parsed.noWorkspace = true;
-      },
-    },
-  });
-  if (args.help) {
-    printHelp();
-    return;
-  }
-
-  const { repos, workspaceRoot } = loadManifestRepos({
-    manifestPath: args.manifest,
-    baseDir: args.baseDir,
-  });
-
-  if (!args.noWorkspace) {
-    showWorkspaceRootRemotes({
-      workspaceRoot,
-      dryRun: args.dryRun,
-    });
-  }
-
-  for (const repo of repos) {
-    if (!ensureRepoExists({ name: repo.name, destination: repo.destination })) {
-      continue;
-    }
-    printRepoRemotes({
-      label: repo.name,
-      destination: repo.destination,
-      dryRun: args.dryRun,
-    });
-  }
-}
-
-try {
-  main();
-} catch (error) {
-  console.error(error.message);
-  process.exit(1);
-}

package/lib/git/git-gst.js

@@ -1,94 +0,0 @@
-#!/usr/bin/env node
-/*
- * Git status for PAN Stack project repositories.
- *
- * oh-my-zsh-style alias for gst — git status on workspace + child repos.
- */
-
-const { parseCommonArgs, loadManifestRepos, printCommonOptions } = require("./helpers/cli");
-const { ensureRepoExists, isGitRepo, runGitStatus } = require("./helpers/git");
-
-function printRepoStatus({ label, destination, dryRun, gitArgs }) {
-  const statusArgs = gitArgs.length > 0 ? gitArgs.join(" ") : "";
-  if (dryRun) {
-    console.log(`[dry-run] (in ${destination}) git status ${statusArgs}`.trim());
-    return;
-  }
-
-  console.log(`== ${label} ==`);
-  console.log(destination);
-  runGitStatus(destination, gitArgs);
-  console.log("");
-}
-
-function showWorkspaceRootStatus({ workspaceRoot, dryRun, gitArgs }) {
-  if (!isGitRepo(workspaceRoot)) {
-    return;
-  }
-
-  printRepoStatus({
-    label: "workspace",
-    destination: workspaceRoot,
-    dryRun,
-    gitArgs,
-  });
-}
-
-function printHelp() {
-  console.log(`usage: git-gst.js [--base-dir BASE_DIR] [--dry-run] [--no-workspace] [manifest] [git status args...]
-
-Run git status for workspace root and each repository in the manifest.
-Extra args are forwarded to git status (e.g. -s, -sb).
-
-${printCommonOptions()}
-  --no-workspace       Skip workspace root (manifest repos only)`);
-}
-
-function main() {
-  const args = parseCommonArgs(process.argv.slice(2), {
-    defaults: { noWorkspace: false, gitArgs: [] },
-    passthrough: true,
-    handlers: {
-      "--no-workspace": (parsed) => {
-        parsed.noWorkspace = true;
-      },
-    },
-  });
-  if (args.help) {
-    printHelp();
-    return;
-  }
-
-  const gitArgs = args.gitArgs || [];
-  const { repos, workspaceRoot } = loadManifestRepos({
-    manifestPath: args.manifest,
-    baseDir: args.baseDir,
-  });
-
-  if (!args.noWorkspace) {
-    showWorkspaceRootStatus({
-      workspaceRoot,
-      dryRun: args.dryRun,
-      gitArgs,
-    });
-  }
-
-  for (const repo of repos) {
-    if (!ensureRepoExists({ name: repo.name, destination: repo.destination })) {
-      continue;
-    }
-    printRepoStatus({
-      label: repo.name,
-      destination: repo.destination,
-      dryRun: args.dryRun,
-      gitArgs,
-    });
-  }
-}
-
-try {
-  main();
-} catch (error) {
-  console.error(error.message);
-  process.exit(1);
-}