@vzn/vx 0.0.474 → 0.0.476

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vzn/vx",
-  "version": "0.0.474",
+  "version": "0.0.476",
   "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.474",
-    "@vzn/vx-linux-arm64": "0.0.474",
-    "@vzn/vx-darwin-x64": "0.0.474",
-    "@vzn/vx-darwin-arm64": "0.0.474"
+    "@vzn/vx-linux-x64": "0.0.476",
+    "@vzn/vx-linux-arm64": "0.0.476",
+    "@vzn/vx-darwin-x64": "0.0.476",
+    "@vzn/vx-darwin-arm64": "0.0.476"
   },
   "dependencies": {
     "@anthropic-ai/sandbox-runtime": "^0.0.76"

package/src/cli/completions.ts

@@ -70,7 +70,14 @@ export function completionScript(shell: CompletionShell, verbs: readonly string[
         ...table.map((t) => `    ${t.verb}) compadd -- ${t.words.join(' ')} ;;`),
         '  esac',
         '}',
-        'compdef _vx vx',
+        // Autoloaded from $fpath (the `#compdef` file), this body runs on
+        // the first Tab: it must complete then, not only define `_vx`, or
+        // that Tab rings the bell. Sourced, it registers instead.
+        'if [[ "${funcstack[1]}" == _vx ]]; then',
+        '  _vx "$@"',
+        'else',
+        '  compdef _vx vx',
+        'fi',
         '',
       ].join('\n')
     case 'fish':

package/src/cli/index.ts

@@ -165,9 +165,15 @@ export async function run(argv: readonly string[]): Promise<number> {
       }
       // A task typed where the verb goes (`turbo build`, `nx build app`),
       // `turbo dev` included: a repo's own `dev` task beats the no-service note.
+      const declaredVerbs =
+        resolved !== null && 'declaredVerbs' in resolved ? resolved.declaredVerbs : []
+      const guess = didYouMeanVerb(command, declaredVerbs)
+      // A typo of a task (`vx biuld`) names the task, unless a verb is closer.
       const task =
         loadNote === ''
-          ? await (await import('./task-verb.js')).taskVerbHint(command, rest, process.cwd())
+          ? await (
+              await import('./task-verb.js')
+            ).taskVerbHint(command, rest, process.cwd(), guess === '' && !command.startsWith('-'))
           : null
       if (task !== null) {
         process.stderr.write(`vx: ${task}\n`)
@@ -207,9 +213,6 @@ export async function run(argv: readonly string[]): Promise<number> {
         )
         return 1
       }
-      const declaredVerbs =
-        resolved !== null && 'declaredVerbs' in resolved ? resolved.declaredVerbs : []
-      const guess = didYouMeanVerb(command, declaredVerbs)
       process.stderr.write(
         `vx: unknown command: ${command}${guess}${loadNote} (see \`vx help\`)\n` +
           (guess === '' && loadNote === '' ? verbSourceNote(resolved, declaredVerbs) : ''),

package/src/cli/plugin-commands.ts

@@ -8,8 +8,9 @@
 // before this is asked, so a plugin cannot shadow `run`.
 
 import type { VxPlugin, PluginCommand, CommandContext } from '../orchestrator/index.js'
-import { findWorkspaceRoot } from '../workspace/index.js'
-import { loadCliWorkspace } from './workspace-config.js'
+import { existsSync } from 'node:fs'
+import path from 'node:path'
+import { findWorkspaceRoot, WORKSPACE_CONFIG_FILENAMES } from '../workspace/index.js'
 import { machineParallelism, maskedLine } from '../util/index.js'
 
 export interface ResolvedPluginCommand {
@@ -52,8 +53,14 @@ async function workspacePlugins(
   } catch {
     return null
   }
+  // Plugins are declared only in a workspace file. Without one, the load
+  // below is the orchestrator's import graph (~50 ms) for an empty list,
+  // paid by `vx help` and by the `vx completions` a shell sources at start.
+  if (!WORKSPACE_CONFIG_FILENAMES.some((f) => existsSync(path.join(workspaceRoot, f))))
+    return { workspaceRoot, cacheDir: '', concurrency: 0, plugins: [] }
   let ws
   try {
+    const { loadCliWorkspace } = await import('./workspace-config.js')
     ws = await loadCliWorkspace(workspaceRoot)
   } catch (err) {
     return { loadError: err instanceof Error ? err.message : String(err) }

package/src/cli/task-verb.ts

@@ -6,28 +6,39 @@
 
 import { nxProjectTarget, projectNamed } from '../orchestrator/index.js'
 import { findWorkspaceRoot, loadWorkspace } from '../workspace/index.js'
+import { nearest } from '../util/index.js'
 import { findCwdProject } from './select.js'
 import { discoverCliProjects, loadCliProjects } from './workspace-config.js'
 
-/** The `vx run` a task typed as a verb means, or null when no project declares it. */
+/**
+ * The `vx run` a task typed as a verb means, or null when no project
+ * declares it. With `typo`, a word a few edits from a task (`vx biuld`)
+ * names that task: the caller passes it only when no verb is closer.
+ */
 export async function taskVerbHint(
   command: string,
   rest: readonly string[],
   cwd: string,
+  typo = false,
 ): Promise<string | null> {
   if (command.includes('#')) return `\`${command}\` is a task: vx run ${command}`
   const projects = await workspaceProjects(cwd)
   if (projects === null) return null
-  if (![...projects.values()].some((p) => p.config.tasks?.[command] !== undefined)) return null
+  const tasks = new Set<string>()
+  for (const p of projects.values()) for (const t of Object.keys(p.config.tasks ?? {})) tasks.add(t)
+  const task = tasks.has(command) ? command : typo ? nearest(command, tasks) : undefined
+  if (task === undefined) return null
   // Nx's `nx build app`: the word after the target is its project.
   const project = rest[0] === undefined ? undefined : projectNamed(rest[0], projects)
   const run =
     project !== undefined
-      ? `vx run ${command} --filter ${project}`
+      ? `vx run ${task} --filter ${project}`
       : (await findCwdProject(cwd)) === null
-        ? `vx run ${command} --all`
-        : `vx run ${command}`
-  return `\`${command}\` is a task here, not a command: ${run}`
+        ? `vx run ${task} --all`
+        : `vx run ${task}`
+  return task === command
+    ? `\`${command}\` is a task here, not a command: ${run}`
+    : `unknown command: ${command}; did you mean the task \`${task}\`? ${run}`
 }
 
 /**

package/src/cli/watch-judge.ts

@@ -13,6 +13,9 @@ const ABSENT = -1n
 function settledState(abs: string): bigint {
   let st: fs.Stats
   try {
+    // A link is its target string, as the key folds it: following it saw
+    // a retarget to equal bytes as "the same" and ran nothing.
+    if (fs.lstatSync(abs).isSymbolicLink()) return xxh3(`link:${fs.readlinkSync(abs)}`)
     st = fs.statSync(abs)
   } catch {
     return ABSENT

package/src/workspace/config-schema.ts

@@ -484,9 +484,16 @@ export function validateProjectConfig(config: ProjectConfig, configPath: string)
       assertKnownFields(cache, CACHE_FIELDS, `${where}.cache`)
       const inputs = (cache as { inputs?: unknown }).inputs
       const outputs = (cache as { outputs?: unknown }).outputs
-      if (!inputs || typeof inputs !== 'object') {
+      // A present field of the wrong shape (`outputs: 'dist'`) was told it
+      // was missing; an array is named in `assertKnownFields`.
+      if (inputs === undefined || inputs === null) {
         throw new UserError(`${where}.cache.inputs is required when \`cache\` is set`)
       }
+      if (typeof inputs !== 'object') {
+        throw new UserError(
+          `${where}.cache.inputs must be an object — \`inputs: { files: [...] }\``,
+        )
+      }
       assertKnownFields(inputs, CACHE_INPUT_FIELDS, `${where}.cache.inputs`)
       if (!Array.isArray((inputs as { files?: unknown }).files)) {
         throw new UserError(`${where}.cache.inputs.files must be an array of glob strings`)
@@ -520,9 +527,14 @@ export function validateProjectConfig(config: ProjectConfig, configPath: string)
           }
         }
       }
-      if (!outputs || typeof outputs !== 'object') {
+      if (outputs === undefined || outputs === null) {
         throw new UserError(`${where}.cache.outputs is required when \`cache\` is set`)
       }
+      if (typeof outputs !== 'object') {
+        throw new UserError(
+          `${where}.cache.outputs must be an object — \`outputs: { files: [...] }\``,
+        )
+      }
       assertKnownFields(outputs, CACHE_OUTPUT_FIELDS, `${where}.cache.outputs`)
       const outFiles = (outputs as { files?: unknown }).files
       if (!Array.isArray(outFiles)) {