@vzn/vx 0.0.437 → 0.0.439

package/package.json

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

package/src/cli/cache.ts

@@ -36,7 +36,8 @@ function cacheSubHint(sub: string): string {
   const elsewhere = CACHE_ELSEWHERE[sub]
   if (elsewhere !== undefined) return ` — ${elsewhere}`
   const best = nearest(sub, ['prune'])
-  return best === undefined ? '' : `. Did you mean ${best}?`
+  // `prune` is the one subcommand: name it when nothing is near (M-58).
+  return best === undefined ? '. The subcommand is prune' : `. Did you mean ${best}?`
 }
 
 export async function cacheCmd(args: readonly string[]): Promise<number> {

package/src/cli/run.ts

@@ -112,7 +112,9 @@ export function parseConcurrency(v: string, cpus = machineParallelism()): number
   return n === null || n < 1 ? null : n
 }
 
-export function parseRunArgs(rawArgs: readonly string[]): RunArgs {
+/** `verb` is the one being parsed for: `vx watch` reads `vx run`'s flags, and
+ * its refusals pointed at `vx run --help` (M-58). */
+export function parseRunArgs(rawArgs: readonly string[], verb: 'run' | 'watch' = 'run'): RunArgs {
   const out: RunArgs = {
     tasks: [],
     filters: [],
@@ -182,7 +184,7 @@ export function parseRunArgs(rawArgs: readonly string[]): RunArgs {
     } else if (RETIRED_EXCLUDE_DEPENDENCIES.test(a ?? '')) {
       return {
         ...out,
-        error: `unknown flag: ${a} (the flag is --exclude-dependencies)${seeHelp('run')}`,
+        error: `unknown flag: ${a} (the flag is --exclude-dependencies)${seeHelp(verb)}`,
       }
     } else if (a === '--exclude-dependencies') {
       out.excludeDependencies = 'all'
@@ -363,7 +365,7 @@ export function parseRunArgs(rawArgs: readonly string[]): RunArgs {
       }
       out.report = fmt
     } else if (a !== undefined && a.startsWith('-')) {
-      return { ...out, error: `unknown flag: ${a}${flagHint('run', a)}${seeHelp('run')}` }
+      return { ...out, error: `unknown flag: ${a}${flagHint(verb, a)}${seeHelp(verb)}` }
     } else if (a !== undefined) {
       out.tasks.push(a)
     }

package/src/cli/watch.ts

@@ -76,7 +76,7 @@ export function watchRefusal(parsed: RunArgs): string | null {
 }
 
 export async function watchCmd(args: readonly string[]): Promise<number> {
-  const parsed = parseRunArgs(args)
+  const parsed = parseRunArgs(args, 'watch')
   if (parsed.error) {
     process.stderr.write(`vx watch: ${parsed.error}\n`)
     return 1

package/src/workspace/config-cache.ts

@@ -254,6 +254,22 @@ export function stripLiterals(source: string, strings?: string[]): string | null
   // expression is told apart from one closing an object literal inside it.
   const templateDepth: number[] = []
   while (i < n) {
+    // Plain code is copied a run at a time, up to the next `/`, quote or
+    // backtick: a character at a time took 9 ms over 1,000 cold configs,
+    // runs take 2 (2026-10-03).
+    if (templateDepth.length === 0) {
+      let j = i
+      while (j < n) {
+        const k = source.charCodeAt(j)
+        if (k === 0x2f || k === 0x27 || k === 0x22 || k === 0x60) break
+        j++
+      }
+      if (j > i) {
+        out += source.slice(i, j)
+        i = j
+        continue
+      }
+    }
     const c = source[i]!
     const next = source[i + 1]
     if (c === '/' && next === '/') {

package/src/workspace/workspace.ts

@@ -1,5 +1,5 @@
 import { constants, type Dirent } from 'node:fs'
-import { access, readdir, stat } from 'node:fs/promises'
+import { access, readdir, realpath, stat } from 'node:fs/promises'
 import path from 'node:path'
 import type { ProjectConfig, WorkspaceConfig } from '../config.js'
 import {
@@ -675,7 +675,17 @@ export async function discoverProjects(
   }
   const projects: ProjectMeta[] = []
   const shared: string[] = []
-  for (const [name, group] of byName) {
+  let rootReal: string | undefined
+  for (const [name, found] of byName) {
+    // One package reached by two paths (a member and a link to it) is one
+    // project, not a name two packages share: `apps/docs -> ../packages/docs`
+    // was refused as a duplicate and told to rename one (D-135). Resolved
+    // only here, so a workspace without a shared name pays nothing.
+    let group = found
+    if (group.length > 1) {
+      rootReal ??= await realpath(workspace.root)
+      group = await oneEntryPerPackage(group, workspace.root, rootReal)
+    }
     if (group.length === 1) {
       const { dir, pkg, configPath } = group[0]!
       projects.push({ name, dir, packageJson: pkg, configPath })
@@ -715,6 +725,32 @@ export async function discoverProjects(
   return projects.sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0))
 }
 
+/**
+ * The entries of a name group, one per real directory. Of several paths to
+ * one package, the one that reaches it through no link inside the
+ * workspace is kept, else the first in path order.
+ */
+async function oneEntryPerPackage<T extends { dir: string }>(
+  group: T[],
+  root: string,
+  rootReal: string,
+): Promise<T[]> {
+  const byReal = new Map<string, T[]>()
+  for (const entry of group) {
+    const real = await realpath(entry.dir)
+    const same = byReal.get(real)
+    if (same === undefined) byReal.set(real, [entry])
+    else same.push(entry)
+  }
+  if (byReal.size === group.length) return group
+  const kept: T[] = []
+  for (const [real, paths] of byReal) {
+    const direct = paths.find((e) => relPosix(root, e.dir) === relPosix(rootReal, real))
+    kept.push(direct ?? paths.sort((a, b) => (a.dir < b.dir ? -1 : 1))[0]!)
+  }
+  return kept
+}
+
 /**
  * A directory a plugin's `discover` hook names, as a project meta; null
  * when `known` already holds it under that name. `by` names the plugin in