@vzn/vx-ci 0.0.651 → 0.0.652

package/README.md

@@ -25,7 +25,8 @@ That's the whole setup. On a GitHub Actions runner (`GITHUB_STEP_SUMMARY`
 set) every `vx run` appends a summary block, on its own line after
 anything already written in the step: verdict headline, stats
 (tasks / executed / cache hits / duration, and the ideal time an executor says
-the run could have taken, as `@vzn/vx-dte` replays it), failures called out above the
+the run could have taken, as `@vzn/vx-dte` replays it), the workers
+that would have run it best (`@vzn/vx-dte`'s "Workers to declare"), failures called out above the
 per-task table (rows by status, failures first, then the longest first) with their exit code, the signal an exit above 128
 stands for (`exit 137 (128 + SIGKILL)`, as the run's own frame and
 `vx last` say it), a timeout as `timed out, exit 143`, a persistent task

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vzn/vx-ci",
-  "version": "0.0.651",
+  "version": "0.0.652",
   "license": "MIT",
   "description": "GitHub Actions and GitLab CI integration for vx — a job summary on Actions and the branch cache scope on both.",
   "keywords": [
@@ -33,7 +33,7 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@vzn/vx": "^0.0.651"
+    "@vzn/vx": "^0.0.652"
   },
   "repository": {
     "type": "git",

package/src/summary.ts

@@ -198,6 +198,9 @@ export function renderJobSummary(summary: RunSummaryRecord, title = 'vx run'): s
   if (summary.machines !== undefined && summary.machines.length > 0) {
     lines.push(...renderWorkers(summary.machines, summary.tasks), '')
   }
+  if (summary.advice !== undefined && summary.advice.length > 0) {
+    lines.push(...renderAdvice(summary.advice), '')
+  }
 
   const header = ['Task', 'Status', 'Duration']
   lines.push(`| ${header.join(' | ')} |`)
@@ -237,6 +240,36 @@ const tasksCell = (ok: number, failed: number): string =>
 
 const pct = (x: number): string => `${Math.round(x * 100)}%`
 
+/** What each `WorkerAdvice` played. */
+const ADVICE = {
+  declared: 'The fewest of the declared sizes',
+  more: "Past the sizes' max",
+  any: 'Any cores, least core time',
+} as const
+
+/**
+ * The workers that would have run it best (2026-11-05: "So I can add more
+ * or change their specs"): played again from what each task took.
+ */
+function renderAdvice(advice: NonNullable<RunSummaryRecord['advice']>): string[] {
+  const lines = [
+    '### Workers to declare',
+    '',
+    '| Played on | Workers | Ends at |',
+    '| --- | --- | --- |',
+  ]
+  for (const a of advice)
+    lines.push(
+      `| ${ADVICE[a.of]} | ${a.workers
+        .map(
+          (w) =>
+            `${w.count} × ${w.size === undefined ? '' : `${escapeMarkdownCell(escapeInline(w.size))} `}(${w.cores} cores, ${gb(w.memoryBytes)} GB${w.platform === undefined ? '' : `, ${escapeMarkdownCell(escapeInline(w.platform))}`})`,
+        )
+        .join(' + ')} | ${fmtMs(a.endMs)} |`,
+    )
+  return lines
+}
+
 /**
  * The workers an executor ran the run on (vx-dte's): the cores its tasks
  * booked beside the cores they used, each averaged over the time the