@vzn/vx 0.0.112 → 0.0.113

package/package.json

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

package/src/cache/cache.ts

@@ -1046,6 +1046,14 @@ export class Cache implements CacheLayer {
       // Same distinction for a tree the process cannot write into — a
       // `dist/` another user owns, a read-only checkout, a full disk: the
       // artifact is intact, the tree is not the process's to change.
+      // A refusal to READ the artifact is the cache directory's, not the
+      // outputs': the old line sent the reader to the wrong tree (A-40).
+      if (isFsRefusal(err) && err.path === src) {
+        throw new UserError(
+          `restore of ${hash} could not read its artifact (${code}: ${err.message}). ` +
+            `Make the cache directory readable by this user, or point cacheDir / --cache-dir at one that is.`,
+        )
+      }
       if (isFsRefusal(err)) {
         const remedy = isDiskFull(err)
           ? 'Free space on that disk and re-run.'

package/src/cli/help.ts

@@ -221,10 +221,10 @@ export function flagHint(verb: string, arg: string): string {
  * reading every flag on it put `--check` in the list, so `vx run --chek`
  * was told "did you mean --check?" and `--check` was then refused.
  */
-export function documentedFlags(verb: string): string[] {
+export function documentedFlags(verb: string, text = helpText()): string[] {
   const flags = new Set<string>()
   let inVerb = false
-  for (const line of helpText().split('\n')) {
+  for (const line of text.split('\n')) {
     if (/^[A-Z][A-Za-z ]*(?: \(for [a-z]+\))?:$/.test(line))
       inVerb = line.endsWith(`(for ${verb}):`)
     if (!inVerb) continue

package/src/exec/runner.ts

@@ -140,8 +140,11 @@ function trailingCommentStart(command: string): number {
 export function withForwardArgs(command: string, args: readonly string[] | undefined): string {
   if (!args || args.length === 0) return command
   const quoted = args.map(shellQuote).join(' ')
-  const comment = trailingCommentStart(command)
+  let comment = trailingCommentStart(command)
   if (comment < 0) return `${command} ${quoted}`
+  // A comment-only last line after a commented line: the args go before
+  // the earliest comment, or they land inside it (`echo one # c\n# two`).
+  for (let c = comment; c >= 0; c = trailingCommentStart(command.slice(0, c).trimEnd())) comment = c
   return `${command.slice(0, comment).trimEnd()} ${quoted} ${command.slice(comment)}`
 }
 

package/src/workspace/config-imports.ts

@@ -171,10 +171,11 @@ function compilerPaths(file: string, memo?: TsconfigMemo, depth = 0): CompilerPa
   if (typeof json !== 'object' || json === null) return {}
   const dir = path.dirname(file)
   const out: CompilerPaths = {}
+  // A string only: Bun follows no array `extends` (TS 5's form), and an
+  // alias only an array maps went to the registry (D-30).
   const ext = (json as { extends?: unknown }).extends
-  for (const base of typeof ext === 'string' ? [ext] : Array.isArray(ext) ? ext : []) {
-    if (depth > 8 || typeof base !== 'string' || !base.startsWith('.')) continue
-    const f = path.resolve(dir, base)
+  if (typeof ext === 'string' && ext.startsWith('.') && depth <= 8) {
+    const f = path.resolve(dir, ext)
     Object.assign(out, compilerPaths(f.endsWith('.json') ? f : f + '.json', memo, depth + 1))
   }
   const opts = (json as { compilerOptions?: unknown }).compilerOptions