@vzn/vx 0.0.474 → 0.0.475

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vzn/vx",
-  "version": "0.0.474",
+  "version": "0.0.475",
   "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.475",
+    "@vzn/vx-linux-arm64": "0.0.475",
+    "@vzn/vx-darwin-x64": "0.0.475",
+    "@vzn/vx-darwin-arm64": "0.0.475"
   },
   "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/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/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)) {