@vzn/vx 0.0.462 → 0.0.464

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vzn/vx",
-  "version": "0.0.462",
+  "version": "0.0.464",
   "description": "The fastest task runner and build cache for JavaScript monorepos.",
   "type": "module",
   "exports": {
@@ -21,10 +21,10 @@
     "node": ">=18"
   },
   "optionalDependencies": {
-    "@vzn/vx-linux-x64": "0.0.462",
-    "@vzn/vx-linux-arm64": "0.0.462",
-    "@vzn/vx-darwin-x64": "0.0.462",
-    "@vzn/vx-darwin-arm64": "0.0.462"
+    "@vzn/vx-linux-x64": "0.0.464",
+    "@vzn/vx-linux-arm64": "0.0.464",
+    "@vzn/vx-darwin-x64": "0.0.464",
+    "@vzn/vx-darwin-arm64": "0.0.464"
   },
   "dependencies": {
     "@anthropic-ai/sandbox-runtime": "^0.0.76"

package/src/cli/run.ts

@@ -667,6 +667,10 @@ export async function runCmd(args: readonly string[]): Promise<number> {
   // the scheduler, cache, retries and telemetry unchanged above it); there
   // is no whole-run delegation seam to consult.
   const summary = await runOrchestrator(opts)
+  if (summary.refused !== undefined) {
+    process.stderr.write(`vx run: ${summary.refused}\n`)
+    return 1
+  }
   const result: RunResult = { ok: summary.ok, outcomes: summary.outcomes.map(projectOutcome) }
   if (parsed.verbosity > 0) printSummary(result)
   // Report generation is post-run, gated on the flags — zero cost when

package/src/cli/watch.ts

@@ -180,6 +180,7 @@ export async function watchCmd(args: readonly string[]): Promise<number> {
   try {
     const initial = await runOrchestrator(opts)
     held = initial.persistent
+    if (initial.refused !== undefined) process.stderr.write(`vx watch: ${initial.refused}\n`)
     // A run that failed having run nothing refused to start: a requested
     // name no project declares (run() says which, with a "did you mean").
     // `vx run` exits 1 on it; `vx watch buidl` watched on, re-running the
@@ -369,7 +370,9 @@ async function runWatchLoop(args: WatchLoopArgs): Promise<number> {
           held = undefined
           restartTimings()
           const start = Date.now()
-          held = (await runOrchestrator(opts)).persistent
+          const cycle = await runOrchestrator(opts)
+          held = cycle.persistent
+          if (cycle.refused !== undefined) process.stderr.write(`vx watch: ${cycle.refused}\n`)
           changes.lastCycle = { start, end: Date.now() }
           if (reread && !stop.aborted) {
             reread = false

package/src/orchestrator/options.ts

@@ -258,6 +258,12 @@ export interface RunSummary {
   outcomes: TaskOutcome[]
   /** The persistent tasks `RunOptions.holdPersistent` handed back; absent when none is running. */
   persistent?: HeldPersistent
+  /**
+   * Why the run refused to start, nothing having run (`ok` is false): a
+   * requested task no selected project declares, with what is near. The
+   * caller prints it; `vx run` writes it to stderr.
+   */
+  refused?: string
 }
 
 export interface HeldPersistent {

package/src/orchestrator/run.ts

@@ -377,13 +377,13 @@ async function runOnBus(
   // a CI job that renames a task must go red, not silently stop running
   // it. When EVERY name is unresolved this is the `no-tasks-declared`
   // case too; the message is identical, so that branch stays below.
+  // A refusal is the caller's to print (on stderr, as `vx run:`): as a
+  // status line it went to stdout, into whatever a script piped there.
   if (prepared.unresolvedTasks.length > 0) {
-    log.status(
-      `No projects declare task(s): ${prepared.unresolvedTasks.join(', ')}.${elsewhereHint(prepared.declaredElsewhere)}${didYouMean(prepared.unresolvedTasks, prepared.hintProjects, prepared.declaredElsewhere)}${await initHint(prepared)}`,
-    )
+    const refused = `no projects declare task(s): ${prepared.unresolvedTasks.join(', ')}.${elsewhereHint(prepared.declaredElsewhere)}${didYouMean(prepared.unresolvedTasks, prepared.hintProjects, prepared.declaredElsewhere)}${await initHint(prepared)}`
     await teardown()
     prepared.cache.close()
-    return { ok: false, outcomes: [] }
+    return { ok: false, outcomes: [], refused }
   }
   if (prepared.empty === 'none-affected') {
     log.status(`No affected project declares task(s): ${options.tasks.join(', ')}.`)
@@ -396,14 +396,13 @@ async function runOnBus(
     // a clear message and return NOT-ok so the script exits 1.
     // `empty-graph` is defensive — unreachable under current
     // buildTaskGraph semantics but logged just in case.
-    const msg =
+    const refused =
       prepared.empty === 'no-tasks-declared'
-        ? `No projects declare task(s): ${options.tasks.join(', ')}.${elsewhereHint(prepared.declaredElsewhere)}${await initHint(prepared)}`
-        : 'No tasks to run.'
-    log.status(msg)
+        ? `no projects declare task(s): ${options.tasks.join(', ')}.${elsewhereHint(prepared.declaredElsewhere)}${await initHint(prepared)}`
+        : 'no tasks to run.'
     await teardown()
     prepared.cache.close()
-    return { ok: false, outcomes: [] }
+    return { ok: false, outcomes: [], refused }
   }
   // Install user plugins as additional bus subscribers BEFORE the run
   // starts emitting events. `installPlugins` runs each plugin's optional