@vzn/vx 0.0.456 → 0.0.457

package/package.json

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

package/src/cache/archive.ts

@@ -41,6 +41,7 @@ import { chmodSync, renameSync, statSync, utimesSync } from 'node:fs'
 import { lstat, mkdir, readlink, realpath, rmdir, stat, unlink, writeFile } from 'node:fs/promises'
 import path from 'node:path'
 import { UserError } from '../util/index.js'
+import { WORKSPACE_OUTPUT_PREFIX } from './layer.js'
 import { TarFormatError, type TarInput, tarEntries, tarPack, tarSize } from './tar-stream.js'
 
 /** Archive entry name carrying the per-output mode/mtime sidecar. */
@@ -236,11 +237,17 @@ export async function planArtifact(args: PackArgs): Promise<ArtifactPlan> {
       // file's bytes and comes back as a regular file. A link to a
       // directory, or a dangling one, has no bytes to pack: refuse loudly
       // rather than store an entry that restores to nothing.
-      const shown = name.startsWith('outputs/') ? name.slice('outputs/'.length) : name
+      // The path as the config spells it: a root-anchored output's entry
+      // name is vx's own `workspace-outputs/…` (M-66).
+      const shown = name.startsWith('outputs/')
+        ? `output ${name.slice('outputs/'.length)}`
+        : name.startsWith(WORKSPACE_OUTPUT_PREFIX)
+          ? `workspaceFiles output ${name.slice(WORKSPACE_OUTPUT_PREFIX.length)}`
+          : `output ${name}`
       const dangling = (err: NodeJS.ErrnoException): never => {
         if (err.code === 'ENOENT') {
           throw new UserError(
-            `output ${shown} is a dangling symlink: vx stores regular files only — emit a file there, or narrow cache.outputs.files to the files the task produces, or take it back with a '!' entry`,
+            `${shown} is a dangling symlink: vx stores regular files only — emit a file there, or narrow cache.outputs.files to the files the task produces, or take it back with a '!' entry`,
           )
         }
         throw err
@@ -256,7 +263,7 @@ export async function planArtifact(args: PackArgs): Promise<ArtifactPlan> {
           const root = await withinReal
           if (!src.startsWith(root + path.sep) && !(await ownOutputs()).has(src)) {
             throw new UserError(
-              `output ${shown} is a symlink to ${src}, outside the project: vx packs a symlinked output as its target's bytes, and a project's outputs come from its own directory — emit a file there, or take it back with a '!' entry`,
+              `${shown} is a symlink to ${src}, outside the project: vx packs a symlinked output as its target's bytes, and a project's outputs come from its own directory — emit a file there, or take it back with a '!' entry`,
             )
           }
         }
@@ -264,7 +271,7 @@ export async function planArtifact(args: PackArgs): Promise<ArtifactPlan> {
       }
       if (!st.isFile()) {
         throw new UserError(
-          `output ${shown} is not a regular file (a symlink to a directory?): vx stores regular files only — emit a file there, or narrow cache.outputs.files to the files the task produces, or take it back with a '!' entry`,
+          `${shown} is not a regular file (a symlink to a directory?): vx stores regular files only — emit a file there, or narrow cache.outputs.files to the files the task produces, or take it back with a '!' entry`,
         )
       }
       const mode = st.mode & 0o777

package/src/cli/index.ts

@@ -28,7 +28,20 @@ export async function run(argv: readonly string[]): Promise<number> {
   }
 
   switch (command) {
-    case undefined:
+    case undefined: {
+      // A bare `vx` where no workspace is printed 151 lines of help, none
+      // of which says the one thing wrong: there is nothing here to run.
+      const { findWorkspaceRoot } = await import('../workspace/index.js')
+      try {
+        await findWorkspaceRoot(process.cwd())
+      } catch (err) {
+        if (!isUserError(err)) throw err
+        process.stderr.write(`vx: ${err.message}; \`vx help\` lists the verbs\n`)
+        return 1
+      }
+      printHelp(await (await plugins()).pluginCommandHelp())
+      return 0
+    }
     case '--help':
     case '-h':
       printHelp(await (await plugins()).pluginCommandHelp())