@vzn/vx 0.0.645 → 0.0.648

package/src/report/summary.ts

@@ -13,8 +13,10 @@ import {
   formatBytes,
   formatElapsed,
   gradientRule,
+  identityColor,
   paint,
   SUCCESS,
+  ui,
   WARN,
   type ColorSupport,
 } from '../util/index.js'
@@ -27,6 +29,7 @@ const LOCAL = '#38bdf8' // sky-400
 const REMOTE = '#2563eb' // blue-600
 const ABORTED = '#f97316' // orange-500: red's neighbour, not a failure
 const NOT_RUN = '#a855f7' // purple-500: stopped before it began, apart from every other state
+const RUNNING = '#06b6d4' // cyan-500: ui's info
 const ACCENT = '#06b6d4' // cyan-500: the live region's running word
 
 /**
@@ -85,6 +88,11 @@ export interface SummaryStats {
   aborted?: number
   /** Reached by the stop before they ran. Not in `total`. */
   notRun?: number
+  /** Live: running now, and handed to an executor whose machine has not begun them. */
+  running?: number
+  scheduled?: number
+  /** Live: not started because a dependency has not finished. */
+  blocked?: number
   total: number
   upToDate: number
   restoredLocal: number
@@ -106,10 +114,12 @@ export interface SummaryStats {
   held?: { count: number; sumMs: number }
   /** Live section only: the forecast of what is left, from history. */
   etaMs?: number
+  /** Live section only: how long the run has gone past that forecast. */
+  overMs?: number
   /** A run of groups only: their names, so `0 tasks` says why. */
   emptyGroups?: readonly string[]
-  /** Each finished task's cache bucket by its key and its id (its run bytes), so its remote traffic can move it. */
-  buckets?: ReadonlyMap<string, CacheBucket>
+  /** Each finished task's id and cache bucket by its key and its id (its run bytes), so its remote traffic can move it. */
+  buckets?: ReadonlyMap<string, TaskBucket>
 }
 
 /** The cache bar segment a finished task fills before its remote traffic is weighed. */
@@ -120,13 +130,26 @@ export type CacheBucket =
   | 'restoredLocal'
   | 'restoredRemote'
   | 'saved'
+  | 'notSaved'
+
+/** A finished task's id and cache bucket, as `SummaryStats.buckets` holds them. */
+export interface TaskBucket {
+  task: string
+  bucket: CacheBucket
+}
 
 /** A finished task's own cache bucket; none for a group, a skip or an abort. */
 export function cacheBucketOf(o: TaskOutcome): CacheBucket | undefined {
   if (isGroupTask(o.node)) return undefined
   switch (o.status) {
     case 'success':
-      return ranNoCache(o) ? 'noCache' : o.saved === true ? 'saved' : 'miss'
+      return ranNoCache(o)
+        ? 'noCache'
+        : o.saved === true
+          ? 'saved'
+          : ranUnsaved(o)
+            ? 'notSaved'
+            : 'miss'
     case 'failed':
       return ranNoCache(o) ? 'noCache' : 'miss'
     case 'cache-hit':
@@ -138,10 +161,12 @@ export function cacheBucketOf(o: TaskOutcome): CacheBucket | undefined {
   }
 }
 
-type Buckets = Record<CacheBucket | 'uploaded' | 'uploading' | 'remoteFailed', number>
+type RemoteState = 'uploaded' | 'uploading' | 'remoteFailed'
+const REMOTE_RANK: Record<RemoteState, number> = { uploaded: 0, uploading: 1, remoteFailed: 2 }
+type Buckets = Record<CacheBucket | RemoteState, number>
 
 /**
- * The cache bar's segments, each task in one (M, 2026-10-15). With layers
+ * The cache bar's segments, each task in one (2026-10-15). With layers
  * named, a saved task leaves the misses, and a task with remote traffic
  * leaves its own bucket for its strongest remote state: a failed read or
  * write, then an upload still running, then one that landed. Without, the
@@ -149,8 +174,12 @@ type Buckets = Record<CacheBucket | 'uploaded' | 'uploading' | 'remoteFailed', n
  */
 function cacheBuckets(stats: SummaryStats, layers: RunContext['cache']): Buckets {
   const saved = layers === undefined ? 0 : (stats.saved ?? 0)
+  // Its own yellow segment, as its legend count is: in the misses' red it
+  // was a cell with no count under it (2026-10-21).
+  const notSaved = layers === undefined ? 0 : (stats.notSaved ?? 0)
   const b: Buckets = {
-    miss: stats.miss - saved,
+    miss: stats.miss - saved - notSaved,
+    notSaved,
     noCache: stats.noCache ?? 0,
     upToDate: stats.upToDate,
     restoredLocal: stats.restoredLocal,
@@ -161,13 +190,20 @@ function cacheBuckets(stats: SummaryStats, layers: RunContext['cache']): Buckets
     remoteFailed: 0,
   }
   if (layers?.remote !== true || stats.buckets === undefined) return b
-  for (const [hash, k] of layers.traffic.keys) {
-    const from = stats.buckets.get(hash)
+  // A task's traffic may sit under its key (its entry) and its id (its run
+  // bytes): it moves once, to the strongest state of the two.
+  const moved = new Map<string, RemoteState>()
+  for (const [key, k] of layers.traffic.keys) {
+    const from = stats.buckets.get(key)
     // Still running: it counts once it ends.
     if (from === undefined) continue
-    b[from]--
-    b[k.failures.length > 0 ? 'remoteFailed' : k.uploading > 0 ? 'uploading' : 'uploaded']++
+    const state: RemoteState =
+      k.failures.length > 0 ? 'remoteFailed' : k.uploading > 0 ? 'uploading' : 'uploaded'
+    const prior = moved.get(from.task)
+    if (prior === undefined) b[from.bucket]--
+    if (prior === undefined || REMOTE_RANK[state] > REMOTE_RANK[prior]) moved.set(from.task, state)
   }
+  for (const state of moved.values()) b[state]++
   return b
 }
 
@@ -183,6 +219,10 @@ export interface RunContext {
   packageCount: number
   /** The run's whole id, as `vx last` takes it; shown on the `info` row. */
   runId?: string | undefined
+  /** The executors' own footer rows (`TaskExecutor.footer`), above the `info` row. */
+  executorRows?: () => readonly (readonly [string, ui.Inline])[]
+  /** Where a running task runs, `null` while it waits for a machine (`TaskExecutor.running`): its live row. */
+  whereRunning?: (taskId: string) => string | null | undefined
   /** Worker-pool size for this run; shown on the `info` row. */
   concurrency?: number
   remoteCacheEnabled: boolean
@@ -212,6 +252,8 @@ export interface RunContext {
   }
   /** Total projects discovery found — the bar's denominator. */
   workspaceProjectCount?: number
+  /** The run's warnings no task owns, as they were said: the footer's `warn` row. */
+  warnings?: () => readonly string[]
 }
 
 export function formatSummarySection(
@@ -226,7 +268,15 @@ export function formatSummarySection(
   const left = stats.left ?? 0
   const aborted = stats.aborted ?? 0
   const notRun = stats.notRun ?? 0
-  const remainder = { n: left, color: '', glyph: '\u25b1', dim: true }
+  const running = stats.running ?? 0
+  const scheduled = stats.scheduled ?? 0
+  const blocked = stats.blocked ?? 0
+  const remainder = {
+    n: Math.max(0, left - running - scheduled - blocked),
+    color: '',
+    glyph: '\u25b1',
+    dim: true,
+  }
 
   const dim = (txt: string) => paint('', txt, colors, { dim: true })
   const row = (label: string, value: string): string => `  ${dim(label.padEnd(8))}  ${value}`
@@ -234,7 +284,7 @@ export function formatSummarySection(
 
   // Tasks meter + numbers, fixed order: failed · success · skipped ·
   // aborted · not run, then a dim total, last on its line. Every task in
-  // the run counts, each state its own segment (M, 2026-10-14).
+  // the run counts, each state its own segment (2026-10-14).
   const runTotal = stats.total + aborted + notRun
   const taskParts: string[] = []
   if (stats.failed > 0)
@@ -243,6 +293,11 @@ export function formatSummarySection(
   if (stats.skipped > 0) taskParts.push(paint(WARN, `${stats.skipped} skipped`, colors))
   if (aborted > 0) taskParts.push(paint(ABORTED, `${aborted} aborted`, colors))
   if (notRun > 0) taskParts.push(paint(NOT_RUN, `${notRun} not run`, colors))
+  if (running > 0) taskParts.push(paint(RUNNING, `${running} running`, colors))
+  if (scheduled > 0) taskParts.push(dim(`${scheduled} scheduled`))
+  if (blocked > 0) taskParts.push(dim(`${blocked} blocked`))
+  // What is not done yet, running included: the count the bar's unfilled part shows.
+  if (left > 0) taskParts.push(dim(`${left} left`))
   if (runTotal > 0) taskParts.push(dim(`${runTotal} total`))
   const taskBar = segmentBar(
     [
@@ -251,6 +306,9 @@ export function formatSummarySection(
       { n: stats.skipped, color: WARN },
       { n: aborted, color: ABORTED },
       { n: notRun, color: NOT_RUN },
+      { n: running, color: RUNNING },
+      { n: scheduled, color: '', dim: true },
+      { n: blocked, color: '', dim: true },
       remainder,
     ],
     colors,
@@ -271,10 +329,10 @@ export function formatSummarySection(
     const wsTotal = context.workspaceProjectCount
     if (wsTotal !== undefined && wsTotal > 0) {
       const width = barWidth(colors)
-      const cells = Math.min(
-        width,
-        Math.max(1, Math.round((context.packageCount / wsTotal) * width)),
-      )
+      const cells =
+        context.packageCount === 0
+          ? 0
+          : Math.min(width, Math.max(1, Math.round((context.packageCount / wsTotal) * width)))
       const bar =
         paint(WARN, '▰'.repeat(cells), colors) +
         paint('', '▱'.repeat(width - cells), colors, { dim: true })
@@ -310,6 +368,7 @@ export function formatSummarySection(
     const cacheBar = segmentBar(
       [
         { n: b.miss, color: ERROR },
+        { n: b.notSaved, color: WARN },
         { n: b.noCache, color: '', dim: true },
         { n: b.upToDate, color: SUCCESS },
         { n: b.restoredLocal, color: LOCAL },
@@ -325,7 +384,7 @@ export function formatSummarySection(
     )
     const cacheParts: string[] = []
     if (layers !== undefined) {
-      // Per layer (M, 2026-10-15): `✓` fresh (outputs already on disk, from
+      // Per layer (2026-10-15): `✓` fresh (outputs already on disk, from
       // either layer) and `∅` no cache, both local; `↓` restored from a
       // layer, `↑` saved to it; `✗` a remote read or write failed, `⇡` still
       // uploading. Each count is its bar segment's, glyph and number in its colour.
@@ -337,7 +396,7 @@ export function formatSummarySection(
         ...(layers.local ? n(b.restoredLocal, '\u2193', LOCAL) : []),
         ...(layers.localWrite ? n(b.saved, '\u2191', LOCAL) : []),
       ]
-      // The layer words are dim; only the counts carry colour (M, 2026-10-15).
+      // The layer words are dim; only the counts carry colour (2026-10-15).
       if (local.length > 0) cacheParts.push(`${dim('local')} ${local.join(' ')}`)
       // Each transfer count is followed by its bytes, dim: what the
       // remote moved is the cost a hit or an upload paid.
@@ -355,8 +414,8 @@ export function formatSummarySection(
       ]
       if (layers.remote && remote.length > 0)
         cacheParts.push(`${dim('remote')} ${remote.join(' ')}`)
-      if ((stats.notSaved ?? 0) > 0)
-        cacheParts.push(paint(WARN, `${stats.notSaved} not saved`, colors))
+      if (b.miss > 0) cacheParts.push(paint(ERROR, `${b.miss} miss`, colors))
+      if (b.notSaved > 0) cacheParts.push(paint(WARN, `${b.notSaved} not saved`, colors))
       const notDownloaded = layers.notDownloaded()
       if (notDownloaded > 0) cacheParts.push(paint(WARN, `${notDownloaded} not downloaded`, colors))
     } else {
@@ -371,7 +430,7 @@ export function formatSummarySection(
     }
     // Skipped tasks ride the bar, yellow like the tasks meter, so the two
     // bars fill alike; their count is the tasks legend's alone (the footer
-    // never says a fact twice, M, 2026-10-14).
+    // never says a fact twice, 2026-10-14).
     lines.push(row('cache', cacheBar))
     if (cacheParts.length > 0) lines.push(legend(cacheParts))
   }
@@ -379,7 +438,7 @@ export function formatSummarySection(
   // Cache-miss duration spread (owner: hits' restore times polluted
   // it — only tasks that actually executed count). Dim: context.
   // A value already on the row is not said again: one executed task read
-  // as its own max, avg and min (M, 2026-10-14). Tasks that all took the
+  // as its own max, avg and min (2026-10-14). Tasks that all took the
   // same time have no spread to show.
   const total = formatElapsed(totalMs)
   const said = new Set([total])
@@ -405,15 +464,34 @@ export function formatSummarySection(
   // that is about the future.
   if (stats.etaMs !== undefined)
     timeParts.push(paint(ACCENT, `${formatEta(stats.etaMs)} left`, colors))
+  else if (stats.overMs !== undefined)
+    timeParts.push(paint(ACCENT, `${formatOver(stats.overMs)} over`, colors))
   for (const p of spreadParts) timeParts.push(dim(p))
   const timeRow = row('time', join(timeParts))
   // Run-shape footer (final summary only): worker pool + cache mode,
   // grouped with time under a blank line below the meters.
   if (context !== undefined) {
+    const own = context.executorRows?.() ?? []
+    if (own.length > 0)
+      lines.push('', ...own.map(([label, text]) => row(label, ui.inline(text, colors))))
     const info: string[] = []
-    if (context.concurrency !== undefined)
+    // An executor that says where tasks ran says it better than the pool.
+    if (context.concurrency !== undefined && own.length === 0)
       info.push(`${context.concurrency} worker${context.concurrency === 1 ? '' : 's'}`)
-    info.push(context.remoteCacheEnabled ? 'local + remote cache' : 'local cache')
+    const layers = context.cache
+    info.push(
+      layers === undefined
+        ? context.remoteCacheEnabled
+          ? 'local + remote cache'
+          : 'local cache'
+        : layers.local && layers.remote
+          ? 'local + remote cache'
+          : layers.local
+            ? 'local cache'
+            : layers.remote
+              ? 'remote cache'
+              : 'no cache',
+    )
     if (context.cacheScope !== undefined) info.push(`scope ${context.cacheScope}`)
     // The plugin's hand on the run: a task a policy held with a worker
     // free would otherwise have started; without the line nothing says
@@ -426,13 +504,33 @@ export function formatSummarySection(
       )
     }
     if (context.runId !== undefined) info.push(`run ${context.runId}`)
-    lines.push('', row('info', join(info)), timeRow)
+    lines.push('', ...warnRows(context.warnings?.() ?? [], row, colors))
+    lines.push(row('info', join(info)), timeRow)
   } else {
     lines.push('', timeRow)
   }
   return lines
 }
 
+/**
+ * A long run scrolls its warnings (a remote cache's 403, a plugin's
+ * failed flush) out of sight, and the footer read as a clean run
+ * (2026-10-27). The footer counts the distinct ones; it does not repeat
+ * them, so a warning stays one line in a log (a refused token costs
+ * ONE line, tests/remote-cache-degrade.test.ts in @vzn/vx-migrate).
+ */
+function warnRows(
+  warnings: readonly string[],
+  row: (label: string, value: string) => string,
+  colors: ColorSupport,
+): string[] {
+  const n = new Set(
+    warnings.map((w) => Bun.stripANSI(w).split('\n')[0]!.trim()).filter((w) => w !== ''),
+  ).size
+  if (n === 0) return []
+  return [row('warn', paint(WARN, `${n} ${n === 1 ? 'warning' : 'warnings'} above`, colors))]
+}
+
 /**
  * A forecast, said as coarsely as it is known: `~4s`, `~2m 05s`, `<1s`
  * once the history says the end is due.
@@ -444,16 +542,27 @@ function formatEta(ms: number): string {
   return `~${Math.floor(s / 60)}m ${String(s % 60).padStart(2, '0')}s`
 }
 
+function formatOver(ms: number): string {
+  const s = Math.max(1, Math.ceil(ms / 1000))
+  return s < 60 ? `+${s}s` : `+${Math.floor(s / 60)}m ${String(s % 60).padStart(2, '0')}s`
+}
+
 /**
  * The `--verbosity 1` per-task table (`RunOptions.summaryTable`). Groups are
- * left out as the footer and `--report` leave them: a group ran no command.
+ * left out as the footer leaves them: a group ran no command. Painted in the
+ * list's vocabulary: header bold violet, ids in their hues, status in its
+ * state colour, rule and durations dim.
  */
-export function formatOutcomeTable(outcomes: readonly TaskOutcome[]): string[] {
+export function formatOutcomeTable(
+  outcomes: readonly TaskOutcome[],
+  colors: ColorSupport = NO_COLOR,
+): string[] {
   const rows = outcomes
     .filter((o) => !isGroupTask(o.node))
     .map((o) => {
       const v = projectOutcome(o)
-      return { task: v.taskId, status: outcomeLabel(v), duration: `${v.durationMs}ms` }
+      const status = neverStarted(o) ? 'not run' : outcomeLabel(v)
+      return { o, task: v.taskId, status, duration: `${v.durationMs}ms` }
     })
   if (rows.length === 0) return []
   const widths = {
@@ -461,17 +570,43 @@ export function formatOutcomeTable(outcomes: readonly TaskOutcome[]): string[] {
     status: Math.max(6, ...rows.map((r) => r.status.length)),
     duration: Math.max(8, ...rows.map((r) => r.duration.length)),
   }
-  const line = (task: string, status: string, duration: string) =>
-    `${task.padEnd(widths.task)}  ${status.padEnd(widths.status)}  ${duration.padStart(widths.duration)}`
-  const header = line('TASK', 'STATUS', 'DURATION')
+  const pad = (text: string, width: number) => ' '.repeat(Math.max(0, width - text.length))
+  const header = `${'TASK'.padEnd(widths.task)}  ${'STATUS'.padEnd(widths.status)}  ${'DURATION'.padStart(widths.duration)}`
+  const dim = (t: string) => paint('', t, colors, { dim: true })
   return [
     '',
-    header,
-    '-'.repeat(header.length),
-    ...rows.map((r) => line(r.task, r.status, r.duration)),
+    paint(TABLE_HEADER, header, colors, { bold: true }),
+    dim('-'.repeat(header.length)),
+    ...rows.map((r) => {
+      const { node } = r.o
+      const id =
+        node.projectName !== undefined && node.taskName !== undefined
+          ? paint(identityColor(node.projectName), node.projectName, colors) +
+            dim('#') +
+            paint(identityColor(node.taskName), node.taskName, colors)
+          : r.task
+      const status = paint(tableStatusColor(r.o), r.status, colors)
+      return `${id}${pad(r.task, widths.task)}  ${status}${pad(r.status, widths.status)}  ${pad(r.duration, widths.duration)}${dim(r.duration)}`
+    }),
   ]
 }
 
+/** violet-400, as the task list's header. */
+const TABLE_HEADER = '#a78bfa'
+
+function tableStatusColor(o: TaskOutcome): string {
+  switch (o.status) {
+    case 'failed':
+      return ERROR
+    case 'skipped':
+      return WARN
+    case 'aborted':
+      return neverStarted(o) ? NOT_RUN : ABORTED
+    default:
+      return SUCCESS
+  }
+}
+
 // Local byte formatter — the orchestrator can't import cli/format.ts
 // (module boundary), and the footer only needs one compact form.
 /** Ran here with a `cache` block, succeeded, and its result was not saved. */
@@ -544,13 +679,14 @@ export function formatRunSummary(
 }
 
 /** Each finished task's cache bucket by its key and by its id. */
-function bucketsOf(outcomes: readonly TaskOutcome[]): Map<string, CacheBucket> {
-  const out = new Map<string, CacheBucket>()
+function bucketsOf(outcomes: readonly TaskOutcome[]): Map<string, TaskBucket> {
+  const out = new Map<string, TaskBucket>()
   for (const o of outcomes) {
     const bucket = cacheBucketOf(o)
     if (bucket === undefined) continue
-    if (o.hash !== undefined) out.set(o.hash, bucket)
-    out.set(o.node.id, bucket)
+    const entry = { task: o.node.id, bucket }
+    if (o.hash !== undefined) out.set(o.hash, entry)
+    out.set(o.node.id, entry)
   }
   return out
 }

package/src/report/terminal-signals.ts

@@ -12,6 +12,7 @@ export interface TerminalSignals {
 export function terminalSignals(
   env: Readonly<Record<string, string | undefined>>,
 ): TerminalSignals {
+  if (inMultiplexer(env)) return { progress: false, notify: false }
   const program = env['TERM_PROGRAM']
   if (program === 'ghostty') return { progress: true, notify: true }
   // iTerm2 posts OSC 9 since 3.0 and draws OSC 9;4 since 3.6.
@@ -24,6 +25,17 @@ export function terminalSignals(
   return { progress: false, notify: false }
 }
 
+/** Inside tmux or screen, which keep the outer terminal's variables (`WT_SESSION`, its `TERM_PROGRAM`). */
+function inMultiplexer(env: Readonly<Record<string, string | undefined>>): boolean {
+  const program = env['TERM_PROGRAM']
+  return (
+    env['TMUX'] !== undefined ||
+    env['STY'] !== undefined ||
+    program === 'tmux' ||
+    program === 'screen'
+  )
+}
+
 function atLeast(version: string | undefined, major: number, minor: number): boolean {
   const m = /^(\d+)\.(\d+)/.exec(version ?? '')
   if (m === null) return false
@@ -50,9 +62,8 @@ export function notifyEscape(text: string): string {
  * tmux and screen pass it through only when configured to.
  */
 export function terminalLinks(env: Readonly<Record<string, string | undefined>>): boolean {
-  if (env['TMUX'] !== undefined || env['STY'] !== undefined) return false
+  if (inMultiplexer(env)) return false
   const program = env['TERM_PROGRAM']
-  if (program === 'tmux' || program === 'screen') return false
   if (program === 'ghostty' || program === 'WezTerm' || program === 'vscode') return true
   if (program === 'iTerm.app') return atLeast(env['TERM_PROGRAM_VERSION'], 3, 1)
   if (env['WT_SESSION'] !== undefined || env['KITTY_WINDOW_ID'] !== undefined) return true

package/src/settings.ts

@@ -15,8 +15,7 @@ import {
 export type SettingKind =
   | { readonly type: 'int'; readonly min: number }
   | { readonly type: 'concurrency' }
-  // `zero`: 0 is a value ("wait for nothing not already done"), not a typo.
-  | { readonly type: 'duration'; readonly timer?: true; readonly zero?: true }
+  | { readonly type: 'duration'; readonly timer?: true }
   // `off`: `false` is a value, 0 bytes (the thing the size bounds is off).
   | { readonly type: 'size'; readonly off?: true }
   | { readonly type: 'bool' }
@@ -48,7 +47,14 @@ export const SETTINGS: readonly Setting[] = [
     path: 'baseBranch',
     kind: { type: 'string' },
     default: "origin/HEAD's branch, then main, then master",
-    doc: 'The default branch: a run on it has no cache scope and a bare `--affected` no base; elsewhere both use the merge base with `origin/<baseBranch>`.',
+    doc: 'The default branch: a run on it has no cache scope and a bare `--affected` no base; elsewhere both use the merge base with `origin/<baseBranch>`. Named alone: `main`, not `origin/main`.',
+  },
+  {
+    path: 'affectedBase',
+    kind: { type: 'string' },
+    default: "a plugin's base commit, else the merge base with `baseBranch`",
+    doc: "The commit a bare `--affected` compares with, on the base branch too. `--affected=<base>` beats it; it beats a plugin's base commit. Env only: a committed base would be stale on the next push.",
+    config: false,
   },
   {
     path: 'run.concurrency',
@@ -316,7 +322,7 @@ export function parseSettingValue(kind: SettingKind, raw: unknown): unknown {
       return parseConcurrency(typeof raw === 'number' ? String(raw) : raw)
     case 'duration': {
       const n = typeof raw === 'string' ? parseDuration(raw) : null
-      if (n === null || (n === 0 && kind.zero !== true)) return null
+      if (n === null || n === 0) return null
       return kind.timer === true && n > MAX_TIMEOUT_MS ? null : n
     }
     case 'size':
@@ -352,10 +358,12 @@ export function settingRefusal(
         : typeof raw === 'string' && /^\d+$/.test(raw)
           ? Number(raw)
           : null
-    if (n !== null && Number.isSafeInteger(n) && n > 0) {
+    const bare = n !== null && Number.isSafeInteger(n) && n > 0
+    // A bare number past the ceiling is past it in either unit it could mean.
+    const ms = bare ? n : typeof raw === 'string' ? parseDuration(raw) : null
+    if (bare && !(kind.timer === true && n > MAX_TIMEOUT_MS)) {
       return `${where} takes a duration with its unit, like '${n}ms' or '${Math.max(1, Math.round(n / 1000))}s' (got ${got})`
     }
-    const ms = typeof raw === 'string' ? parseDuration(raw) : null
     if (kind.timer === true && ms !== null && ms > MAX_TIMEOUT_MS) {
       return (
         `${where} of ${got} exceeds the maximum timer delay (${MAX_TIMEOUT_MS} ms, ~24.8 days): ` +

package/src/util/bun-version.ts

@@ -20,8 +20,11 @@
  * refusing would be heavier than the measurement supports. What the
  * measurement supports is that a green exit can hide a truncated answer, and
  * that is what the warning says.
+ *
+ * 1.4.4: vx expands a brace range (`{1..3}`) as `Bun.Glob` does from 1.4.4
+ * on; an older `Bun.Glob` reads it as text, so a scan and a match disagree.
  */
-export const MIN_BUN = [1, 4, 0] as const
+export const MIN_BUN = [1, 4, 4] as const
 
 /** True when `version` is older than {@link MIN_BUN}. */
 export function isUnsupportedBun(version: string): boolean {

package/src/util/colors.ts

@@ -34,6 +34,7 @@ export interface PaintOptions {
  *   NO_COLOR non-empty          → off (overrides FORCE_COLOR)
  *   FORCE_COLOR=0 or =false     → off, even on a TTY
  *   FORCE_COLOR any other value → on (the empty string too)
+ *   a CI whose log renders ANSI (`ciPaints`) → on
  *   else: on iff stdout is a TTY that is not `TERM=dumb`.
  * `0` and `false` are the convention's "off" (supports-color, chalk,
  * Node); reading every non-empty value as on painted a piped CI log that
@@ -45,7 +46,7 @@ export function detectColors(stream: NodeJS.WriteStream = process.stdout): Color
     ? false
     : force !== undefined
       ? force !== '0' && force !== 'false'
-      : stream.isTTY === true && !dumbTerminal()
+      : ciPaints() || (stream.isTTY === true && !dumbTerminal())
   return {
     enabled,
     get columns() {
@@ -54,6 +55,20 @@ export function detectColors(stream: NodeJS.WriteStream = process.stdout): Color
   }
 }
 
+/**
+ * A CI whose log viewer renders ANSI colour though the job's output is a
+ * pipe (supports-color reads the same variables): its log was plain.
+ */
+function ciPaints(): boolean {
+  const env = process.env
+  return (
+    env['GITHUB_ACTIONS'] === 'true' ||
+    env['GITLAB_CI'] === 'true' ||
+    env['BUILDKITE'] === 'true' ||
+    env['CIRCLECI'] === 'true'
+  )
+}
+
 /**
  * `TERM=dumb` (Emacs `M-x shell`, some CI log viewers) can neither paint
  * nor move the cursor: vx prints to it as off a terminal.
@@ -81,7 +96,9 @@ export function paint(
   colors: ColorSupport,
   opts: PaintOptions = {},
 ): string {
-  if (!colors.enabled) return text
+  // Empty text paints nothing: an escape pair around no text is bytes and no
+  // mark (a full bar's empty remainder).
+  if (!colors.enabled || text === '') return text
   let prefix = ''
   if (opts.bold) prefix += BOLD
   if (opts.dim) prefix += DIM
@@ -92,7 +109,7 @@ export function paint(
 
 /**
  * Identity hues for the two halves of a `project#task` id, never a status
- * colour: one name, one hue, in every run, list and row (M, 2026-10-15:
+ * colour: one name, one hue, in every run, list and row (2026-10-15:
  * every `#build` matches every other `#build`).
  */
 const IDENTITY_PALETTE = [

package/src/util/config-frame.ts

@@ -18,7 +18,7 @@ const HEAD = /^(\/[^\n]*?\/(?:vx\.config|\.vx\/workspace)\.[cm]?[jt]s)(?:: (task
  */
 export function configErrorFrame(message: string, cwd: string): string | undefined {
   const head = HEAD.exec(message)
-  if (head === null) return undefined
+  if (head === null) return positionFrame(message, cwd)
   const [, file, fieldPath, colon] = head as unknown as [string, string, string?, string?]
   const rest = message.slice(head[0].length)
   // The field the refusal is about, past the path that leads to it:
@@ -35,6 +35,37 @@ export function configErrorFrame(message: string, cwd: string): string | undefin
   }
   const at = locate(source, segments)
   if (at === undefined) return undefined
+  return framed(file, source, at, message.slice(file.length), cwd)
+}
+
+// The loader's `Project config <file>:<line>:<col>: …`: a syntax error,
+// placed by Bun, in the config itself.
+const POSITION =
+  /^(?:Project|Workspace) config (\/[^\n]*?\/(?:vx\.config|\.vx\/workspace)\.[cm]?[jt]s):(\d+):(\d+)(: [^]*)$/
+
+function positionFrame(message: string, cwd: string): string | undefined {
+  const pos = POSITION.exec(message)
+  if (pos === null) return undefined
+  const [, file, line, col, rest] = pos as unknown as [string, string, string, string, string]
+  let source: string
+  try {
+    source = readFileSync(file, 'utf8')
+  } catch {
+    return undefined
+  }
+  const at = { line: Number(line), col: Math.max(1, Number(col)) }
+  if (at.line < 1 || at.line > source.split('\n').length) return undefined
+  return framed(file, source, at, rest, cwd)
+}
+
+/** `<file>:<line>:<col><rest>` relative to `cwd`, over the source lines up to `at`. */
+function framed(
+  file: string,
+  source: string,
+  at: { line: number; col: number },
+  rest: string,
+  cwd: string,
+): string {
   const lines = source.split('\n')
   // Relative to where the user stands, unless that means climbing out.
   const rel = path.relative(cwd, file)
@@ -50,7 +81,7 @@ export function configErrorFrame(message: string, cwd: string): string | undefin
     .replace(/\t/g, '  ')
     .replace(/\S/g, ' ')
   frame.push(`  ${' '.repeat(width)} | ${lead}^`)
-  return `${shown}:${at.line}:${at.col}${message.slice(file.length)}\n\n${frame.join('\n')}`
+  return `${shown}:${at.line}:${at.col}${rest}\n\n${frame.join('\n')}`
 }
 
 /**
@@ -106,14 +137,20 @@ export function configRefusal(message: string, cwd: string): ConfigRefusal | und
   const cut = framed.indexOf('\n\n')
   const line = framed.slice(0, cut)
   const frame = framed.slice(cut + 2)
-  const at = /^(\S+?:\d+:\d+):? (.*)$/s.exec(line)
+  // A path may hold spaces (`packages/my app/`); the first `:line:col` ends it.
+  const at = /^([^\n]+?:\d+:\d+):? (.*)$/s.exec(line)
   if (at === null) return { where: line, problem: '', frame }
-  const said = /^(.*?)(?: \(allowed: ([^)]*)\))?(?: — did you mean ([^?]+)\?)?$/s.exec(at[2]!)!
+  // After ` — `: the field meant, or how vx spells another runner's field.
+  const said =
+    /^(.*?)(?: \(allowed: ([^)]*)\))?(?: — (?:did you mean ([^?]+)\?|vx spells it (.+)))?$/s.exec(
+      at[2]!,
+    )!
   return {
     where: at[1]!,
     problem: said[1]!.replace(/^has /, ''),
     ...(said[2] !== undefined ? { allowed: said[2] } : {}),
     ...(said[3] !== undefined ? { fix: `use ${said[3]}` } : {}),
+    ...(said[4] !== undefined ? { fix: `use ${said[4]}` } : {}),
     frame,
   }
 }