@vzn/vx 0.0.38 → 0.0.40

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vzn/vx",
-  "version": "0.0.38",
+  "version": "0.0.40",
   "description": "An open, extensible monorepo task runner.",
   "type": "module",
   "exports": {
@@ -17,10 +17,10 @@
     "node": ">=18"
   },
   "optionalDependencies": {
-    "@vzn/vx-linux-x64": "0.0.38",
-    "@vzn/vx-linux-arm64": "0.0.38",
-    "@vzn/vx-darwin-x64": "0.0.38",
-    "@vzn/vx-darwin-arm64": "0.0.38"
+    "@vzn/vx-linux-x64": "0.0.40",
+    "@vzn/vx-linux-arm64": "0.0.40",
+    "@vzn/vx-darwin-x64": "0.0.40",
+    "@vzn/vx-darwin-arm64": "0.0.40"
   },
   "dependencies": {
     "@anthropic-ai/sandbox-runtime": "^0.0.76"

package/src/cli/help.ts

@@ -49,7 +49,7 @@ export function helpText(pluginCommands: readonly string[] = []): string {
     '  vx why [TASK | PKG#TASK] [--run <runId>] [--format pretty|json] [--cache-dir <path>]',
     '  vx last [RUNID] [--list[=N]] [--format pretty|json] [--cache-dir <path>]',
     '  vx completions bash|zsh|fish',
-    '  vx help',
+    '  vx help [VERB]',
     '  vx version',
     '',
     'Selection (for run):',

package/src/cli/index.ts

@@ -32,9 +32,17 @@ export async function run(argv: readonly string[]): Promise<number> {
     case undefined:
     case '--help':
     case '-h':
-    case 'help':
       printHelp(await pluginCommandHelp())
       return 0
+    case 'help': {
+      // `vx help run` is the same question as `vx run --help`. A plugin verb
+      // owns its own help, so anything but a core verb gets the whole
+      // reference, which lists the plugin verbs.
+      const verb = rest[0]
+      const core = verb !== undefined && (CORE_VERBS as readonly string[]).includes(verb)
+      printHelp(await pluginCommandHelp(), core ? verb : undefined)
+      return 0
+    }
     case '--version':
     case 'version':
       process.stdout.write(`vx ${VERSION}\n`)

package/src/cli/last.ts

@@ -14,7 +14,7 @@ import {
   listInvocations,
   type RunSummaryRow,
 } from '../orchestrator/index.js'
-import { UserError } from '../util/index.js'
+import { formatElapsed, UserError } from '../util/index.js'
 import { findWorkspaceRoot } from '../workspace/index.js'
 import { cliCacheDir, parseCacheDirFlag, warnToStderr } from './workspace-config.js'
 
@@ -78,12 +78,7 @@ export function parseLastArgs(args: readonly string[]): LastArgs {
 
 const fmtWhen = (ms: number): string => new Date(ms).toISOString()
 
-function fmtMs(ms: number): string {
-  if (ms < 1000) return `${Math.round(ms)}ms`
-  if (ms < 60_000) return `${(ms / 1000).toFixed(2)}s`
-  const m = Math.floor(ms / 60_000)
-  return `${m}m ${Math.round((ms - m * 60_000) / 1000)}s`
-}
+const fmtMs = (ms: number): string => formatElapsed(ms, true)
 
 /**
  * What an executed task used — its peak RSS and its CPU parallelism (CPU

package/src/orchestrator/summary.ts

@@ -8,6 +8,7 @@ import type { FlakyFinding } from './failure-mode.js'
 import { paint, type ColorSupport } from './colors.js'
 import { tallyOutcomes } from './tally.js'
 import { isGroupTask } from '../graph/index.js'
+import { formatElapsed } from '../util/index.js'
 
 const NO_COLOR: ColorSupport = { enabled: false }
 
@@ -421,6 +422,5 @@ export function formatFlakySection(findings: readonly FlakyFinding[]): string[]
 }
 
 export function formatDuration(ms: number): string {
-  if (ms < 1000) return `${Math.round(ms)}ms`
-  return `${(ms / 1000).toFixed(2)}s`
+  return formatElapsed(ms)
 }

package/src/util/index.ts

@@ -17,7 +17,7 @@ export {
 } from './errors.js'
 export { xxh3, xxh3hex } from './hash.js'
 export { mark, printTimings, span } from './timing.js'
-export { clampInt, MAX_TIMEOUT_MS, parseDecimalInt } from './num.js'
+export { clampInt, formatElapsed, MAX_TIMEOUT_MS, parseDecimalInt } from './num.js'
 export {
   asTrees,
   BUN_GLOB_WILDCARDS,

package/src/util/num.ts

@@ -35,3 +35,17 @@ export function parseDecimalInt(input: string): number | null {
   const n = Number(input)
   return Number.isSafeInteger(n) ? n : null
 }
+
+/**
+ * `ms` as vx prints a duration: whole milliseconds below a second, seconds
+ * to two places, and with `minutes` whole minutes and seconds from a
+ * minute on. Rounded to the unit shown BEFORE the unit is chosen: 999.6 ms
+ * printed `1000ms`, 59,996 ms `60.00s` and 119,600 ms `1m 60s` (item 1034).
+ */
+export function formatElapsed(ms: number, minutes = false): string {
+  if (Math.round(ms) < 1000) return `${Math.round(ms)}ms`
+  const hundredths = Math.round(ms / 10)
+  if (!minutes || hundredths < 6000) return `${(hundredths / 100).toFixed(2)}s`
+  const s = Math.round(ms / 1000)
+  return `${Math.floor(s / 60)}m ${s % 60}s`
+}