@plexus-ms/cli 0.8.0 → 0.9.0

package/dist/plx.js

@@ -8240,7 +8240,7 @@ function latestTag(tags) {
   return tags.filter((t) => /^v?\d/.test(t)).sort((a, b) => compareTrains(a.replace(/^v/, ""), b.replace(/^v/, ""))).at(-1);
 }
 async function readTrain(ctx, upstream) {
-  const repos = [];
+  const repos2 = [];
   const all = /* @__PURE__ */ new Set();
   for (const name of TRAIN_REPOS) {
     const path3 = join4(upstream, name);
@@ -8260,10 +8260,10 @@ async function readTrain(ctx, upstream) {
     const tag = latestTag(tags);
     const range = tag ? `${tag}..HEAD` : "HEAD";
     const pending = (await ctx.read("git", ["log", "--oneline", range], { cwd: path3 })).split("\n").filter(Boolean);
-    repos.push({ name, path: path3, tag, latest: tag?.replace(/^v/, ""), pending });
+    repos2.push({ name, path: path3, tag, latest: tag?.replace(/^v/, ""), pending });
   }
-  const latest = repos.map((r) => r.latest);
-  return { repos, last: latestTag([...all]), skew: latest.some((l) => l !== latest[0]) };
+  const latest = repos2.map((r) => r.latest);
+  return { repos: repos2, last: latestTag([...all]), skew: latest.some((l) => l !== latest[0]) };
 }
 async function preflightRelease(ctx, train) {
   for (const { name, path: path3 } of train.repos) {
@@ -8557,8 +8557,41 @@ var PRUNED = /* @__PURE__ */ new Set([
   ".terraform",
   ".gradle"
 ]);
-function overview(ctx, root, options = {}) {
-  return walk(ctx, root, root.replace(/\/+$/, "").split("/").pop() || root, { git: true, ...options });
+var FETCHES = 8;
+async function overview(ctx, root, options = {}) {
+  const opts = { git: true, fetch: false, ...options };
+  const tree = await walk(ctx, root, root.replace(/\/+$/, "").split("/").pop() || root, opts);
+  if (opts.git && opts.fetch)
+    await syncAll(ctx, repos(tree));
+  return tree;
+}
+function repos(dir) {
+  return [...dir.git ? [dir] : [], ...dir.children.flatMap(repos)];
+}
+async function syncAll(ctx, dirs) {
+  const queue = [...dirs];
+  const worker = async () => {
+    for (let dir = queue.shift(); dir; dir = queue.shift())
+      await sync(ctx, dir);
+  };
+  await Promise.all(Array.from({ length: Math.min(FETCHES, queue.length) }, worker));
+}
+async function sync(ctx, dir) {
+  const facet2 = dir.git;
+  if (!facet2)
+    return;
+  try {
+    await ctx.read("git", ["fetch", "--all", "--quiet"], { cwd: dir.path });
+  } catch (error) {
+    dir.problems ??= [];
+    dir.problems.push(`git fetch: ${error instanceof Error ? error.message : String(error)}`);
+  }
+  const counts = await git(ctx, dir.path, ["rev-list", "--left-right", "--count", "HEAD...@{upstream}"]);
+  const [ahead, behind] = (counts ?? "").split(/\s+/).map(Number);
+  if (ahead === void 0 || behind === void 0 || Number.isNaN(ahead) || Number.isNaN(behind))
+    return;
+  facet2.ahead = ahead;
+  facet2.behind = behind;
 }
 async function walk(ctx, path3, name, options) {
   const entries = await ctx.readDir(path3);
@@ -8958,7 +8991,7 @@ async function preflightSelf(ctx, running) {
     return;
   }
   if (compareTrains(running, latest) < 0)
-    throw new Error(`plx ${running} is behind ${latest}, the newest release; update it first: mise up npm:${SELF_PACKAGE}`);
+    throw new Error(`plx ${running} is behind ${latest}, the newest release; update it first: mise cache clear npm:${SELF_PACKAGE} && mise up npm:${SELF_PACKAGE}`);
 }
 
 // ../lib/dist/ship.js
@@ -14035,9 +14068,9 @@ function renderReport(report, s, showCurrent) {
 // src/commands/overview.ts
 import { resolve as resolve6 } from "node:path";
 function register6(program2) {
-  program2.command("overview").description("map the git repos, copier templates and projects, and Plexus units under a directory").argument("[dir]", "directory to map", ".").option("--color", "colour the tree even when piped").option("--no-color", "never colour the tree").action(async (dir, opts, command) => {
+  program2.command("overview").description("map the git repos, copier templates and projects, and Plexus units under a directory").argument("[dir]", "directory to map", ".").option("-s, --sync", "fetch every repo first, to show branches behind (or ahead of) their upstream").option("--color", "colour the tree even when piped").option("--no-color", "never colour the tree").action(async (dir, opts, command) => {
     const ctx = contextOf2(command);
-    const tree = await overview(ctx, resolve6(dir));
+    const tree = await overview(ctx, resolve6(dir), { fetch: opts.sync ?? false });
     const s = style(opts.color ?? colorByDefault());
     ctx.result(tree, (t) => renderTree(t, s, ctx.verbose >= 1));
   });
@@ -14061,9 +14094,10 @@ function renderTree(root, s, modules) {
 function annotate(dir, s, modules) {
   const tags = [];
   if (dir.git) {
-    const { branch, dirty, tag, remote } = dir.git;
+    const { branch, dirty, tag, remote, ahead, behind } = dir.git;
+    const drift = `${behind ? ` \u2193${behind}` : ""}${ahead ? ` \u2191${ahead}` : ""}`;
     const rest = `${tag ? ` ${tag}` : ""}${remote ? ` \u2192 ${remote}` : ""}]`;
-    tags.push(`${s.ok(`[${branch}`)}${dirty ? s.warn("*") : ""}${s.ok(rest)}`);
+    tags.push(`${s.ok(`[${branch}`)}${dirty ? s.warn("*") : ""}${drift ? s.warn(drift) : ""}${s.ok(rest)}`);
   }
   if (dir.template) tags.push(s.note(`[template ${dir.template.tag ?? "untagged"}]`));
   if (dir.copier) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plexus-ms/cli",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "plx, the Plexus command-line tool: a single-script adapter over @plexus-ms/lib",
   "license": "GPL-3.0-or-later",
   "type": "module",
@@ -24,7 +24,7 @@
   },
   "dependencies": {
     "@inquirer/prompts": "^8.7.4",
-    "@plexus-ms/lib": "0.8.0",
+    "@plexus-ms/lib": "0.9.0",
     "commander": "^15.0.0"
   },
   "devDependencies": {