@vzn/vx 0.0.186 → 0.0.188

package/package.json

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

package/src/cli/run.ts

@@ -16,6 +16,7 @@ import {
 import type { ContinueMode } from '../graph/index.js'
 import { type CachePolicy, FULL_CACHE_POLICY, parseCachePolicy } from '../cache/index.js'
 import { findCwdProject, pickTask, resolveFilters } from './select.js'
+import { nxTargetHint } from './task-verb.js'
 import { MAX_TIMEOUT_MS, isUserError, parseDecimalInt, machineParallelism } from '../util/index.js'
 import { formatGraphDot, formatPlanJson, formatPlanText } from './plan-format.js'
 
@@ -512,6 +513,8 @@ export async function resolveRunOptions(
   } else {
     const cwdProject = await findCwdProject(cwd)
     if (!cwdProject) {
+      const nx = await nxTargetHint(tasks, cwd)
+      if (nx !== null) return { error: nx }
       return {
         error:
           'not inside a project. Pass --all for every project, --filter <pattern> to filter, or run from within a project directory.',

package/src/cli/task-verb.ts

@@ -4,6 +4,7 @@
 // does it. It stays a refusal: a verb that runs whatever task shares its
 // name would change meaning the day a plugin declares that verb.
 
+import { nxProjectTarget } from '../orchestrator/index.js'
 import { findWorkspaceRoot, listProjects, loadWorkspace } from '../workspace/index.js'
 import { findCwdProject } from './select.js'
 import { loadCliProjects } from './workspace-config.js'
@@ -15,16 +16,8 @@ export async function taskVerbHint(
   cwd: string,
 ): Promise<string | null> {
   if (command.includes('#')) return `\`${command}\` is a task: vx run ${command}`
-  let projects: Awaited<ReturnType<typeof loadCliProjects>>
-  try {
-    const root = await findWorkspaceRoot(cwd)
-    projects = await loadCliProjects(root, await listProjects(await loadWorkspace(root)), 'all', {
-      noCreate: true,
-    })
-  } catch {
-    // No workspace, or a config that does not load: the plain unknown-command line stands.
-    return null
-  }
+  const projects = await workspaceProjects(cwd)
+  if (projects === null) return null
   if (![...projects.values()].some((p) => p.config.tasks?.[command] !== undefined)) return null
   // Nx's `nx build app`: the word after the target is its project.
   const project = rest[0] !== undefined && projects.has(rest[0]) ? rest[0] : undefined
@@ -36,3 +29,30 @@ export async function taskVerbHint(
         : `vx run ${command}`
   return `\`${command}\` is a task here, not a command: ${run}`
 }
+
+/**
+ * `vx run web:build` outside a project, as `nx run web:build` is typed:
+ * the `vx run` of each name that is Nx's `project:target` here, or null.
+ */
+export async function nxTargetHint(tasks: readonly string[], cwd: string): Promise<string | null> {
+  if (!tasks.some((t) => t.includes(':'))) return null
+  const projects = await workspaceProjects(cwd)
+  if (projects === null) return null
+  const specs = tasks.map((t) => nxProjectTarget(t, projects))
+  if (specs.some((s) => s === undefined)) return null
+  return `\`${tasks.join(' ')}\` is Nx's project:target: vx run ${specs.join(' ')}`
+}
+
+async function workspaceProjects(
+  cwd: string,
+): Promise<Awaited<ReturnType<typeof loadCliProjects>> | null> {
+  try {
+    const root = await findWorkspaceRoot(cwd)
+    return await loadCliProjects(root, await listProjects(await loadWorkspace(root)), 'all', {
+      noCreate: true,
+    })
+  } catch {
+    // No workspace, or a config that does not load: the caller's plain line stands.
+    return null
+  }
+}

package/src/orchestrator/index.ts

@@ -1,7 +1,7 @@
 // Module contract for `orchestrator`. Cross-module imports must come
 // through here (enforced by tests/module-boundaries.test.ts).
 
-export { run, planRun } from './run.js'
+export { run, planRun, nxProjectTarget } from './run.js'
 export { prepareRun, type PreparedRun } from './prepare.js'
 export {
   loadProjects,

package/src/orchestrator/run.ts

@@ -1298,6 +1298,11 @@ function didYouMean(
   const hints = new Set<string>()
   for (const spec of unresolved) {
     const at = spec.indexOf('#')
+    const nx = nxProjectTarget(spec, projects)
+    if (nx !== undefined) {
+      hints.add(nx)
+      continue
+    }
     if (at < 0) {
       const t = nearest(spec, allTasks)
       if (t !== undefined) hints.add(t)
@@ -1315,6 +1320,23 @@ function didYouMean(
   return hints.size === 0 ? '' : ` Did you mean ${[...hints].join(', ')}?`
 }
 
+/**
+ * Nx's `project:target` (`nx run web:build`) as vx spells it, `web#build`,
+ * when that project declares that task; a name with a colon is otherwise
+ * a task of its own (`build:prod`).
+ */
+export function nxProjectTarget(
+  spec: string,
+  projects: ReadonlyMap<string, ProjectEntry>,
+): string | undefined {
+  const colon = spec.indexOf(':')
+  if (colon <= 0 || spec.includes('#')) return undefined
+  const [project, task] = [spec.slice(0, colon), spec.slice(colon + 1)]
+  return projects.get(project)?.config.tasks?.[task] === undefined
+    ? undefined
+    : `${project}#${task}`
+}
+
 /** The executed, keyed outcomes of a run — what flakiness is judged on. */
 function flakyCandidates(outcomes: readonly TaskOutcome[]): FlakyCandidate[] {
   const out: FlakyCandidate[] = []