@vzn/vx 0.0.98 → 0.0.99

package/package.json

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

package/src/cli/show.ts

@@ -70,7 +70,12 @@ export async function showCmd(args: readonly string[]): Promise<number> {
         ? parsed.target
         : parsed.target.slice(0, hashAt)
   const taskName = hashAt === -1 ? undefined : parsed.target!.slice(hashAt + 1)
-  if (taskName === '') throw new UserError(`missing task name after '#' in "${parsed.target}"`)
+  if (taskName === '') {
+    const list = projectName === '' ? 'vx show' : `vx show ${projectName}`
+    throw new UserError(
+      `vx show: missing task name after '#' in "${parsed.target}" (${list} lists the tasks)`,
+    )
+  }
   if (projectName !== undefined && (taskName !== undefined || byName.has(projectName))) {
     if (!byName.has(projectName)) {
       throw new UserError(

package/src/cli/upgrade.ts

@@ -105,11 +105,15 @@ export function releaseAsset(release: unknown, name: string): ReleaseAsset {
       typeof a === 'object' && a !== null && (a as { name?: unknown }).name === name,
   )
   if (asset === undefined) {
-    throw new UserError(`vx upgrade: release ${tag} has no asset ${name} for this platform`)
+    throw new UserError(
+      `vx upgrade: release ${tag} has no asset ${name} for this platform — nothing replaced; npm install -g @vzn/vx@latest installs it instead`,
+    )
   }
   const url = asset.browser_download_url
   if (typeof url !== 'string' || url.length === 0) {
-    throw new UserError(`vx upgrade: release ${tag} names no download for ${name}`)
+    throw new UserError(
+      `vx upgrade: release ${tag} names no download for ${name} — nothing replaced; npm install -g @vzn/vx@latest installs it instead`,
+    )
   }
   const digest = asset.digest
   const m = typeof digest === 'string' ? /^sha256:([0-9a-f]{64})$/i.exec(digest) : null
@@ -217,13 +221,15 @@ export async function replaceBinary(
 ): Promise<void> {
   const res = await fetchOrRefuse(url, { redirect: 'follow' }, 'download the release asset')
   if (!res.ok) {
-    throw new UserError(`vx upgrade: download failed (${res.status}) — ${url}`)
+    throw new UserError(
+      `vx upgrade: download failed (${res.status}) — ${url} — nothing replaced; re-run`,
+    )
   }
   const bytes = new Uint8Array(
     await readOrRefuse(() => res.arrayBuffer(), url, 'download the release asset'),
   )
   if (bytes.byteLength === 0) {
-    throw new UserError(`vx upgrade: empty download — ${url}`)
+    throw new UserError(`vx upgrade: empty download — ${url} — nothing replaced; re-run`)
   }
   const got = new Bun.CryptoHasher('sha256').update(bytes).digest('hex')
   if (got !== sha256.toLowerCase()) {

package/src/workspace/migration.ts

@@ -357,7 +357,13 @@ function renderConfigFile(
   if (p.importLines.length > 0) lines.push(...p.importLines)
   lines.push('', 'export default {', '  tasks: {')
   for (const t of p.tasks) {
-    for (const todo of t.todos) lines.push(`    // TODO(vx-migrate): ${todo}`)
+    // A reason can quote a manifest's own text (an Nx `env` key), and a
+    // line break there ended the comment: the rest was code in the file
+    // the next run evaluates (D-21). Each line stays inside the comment.
+    for (const todo of t.todos) {
+      const [first, ...rest] = todo.split(/\r\n|[\n\r\u2028\u2029]/)
+      lines.push(`    // TODO(vx-migrate): ${first}`, ...rest.map((l) => `    //   ${l}`))
+    }
     if (t.task === null) continue // skipped target — the TODO above explains
     // `__proto__: {…}` in a literal SETS the prototype, quoted or not, and
     // the run refused the config (item 1033); a computed key is a property.