@vzn/vx 0.0.277 → 0.0.278

package/package.json

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

package/src/cli/show.ts

@@ -6,6 +6,7 @@
 // <task>`: one task. `<task>`: that task in every project declaring it.
 // Deliberately NOT the lock — vx-lock.json is already the frozen JSON.
 
+import path from 'node:path'
 import type { ProjectConfig, TaskConfig } from '../config.js'
 import { declaredTask } from '../graph/index.js'
 import { flagHint, seeHelp } from './help.js'
@@ -65,6 +66,10 @@ export async function showCmd(args: readonly string[]): Promise<number> {
   const metas = await discoverCliProjects(await loadWorkspace(root, reads))
   const byName = new Map(metas.map((m) => [m.name, m]))
 
+  // `//#task` is Turbo's root package's task: the root project here (D-39).
+  const rootMeta = metas.find((m) => path.resolve(m.dir) === path.resolve(root))
+  if (parsed.target?.startsWith('//#') && rootMeta !== undefined)
+    parsed.target = `${rootMeta.name}#${parsed.target.slice(3)}`
   const hashAt = parsed.target?.indexOf('#') ?? -1
   const projectName =
     parsed.target === undefined

package/src/cli/why.ts

@@ -5,6 +5,7 @@
 // names the exact cache-key components that differ. Read-only over cache.db —
 // no config evaluation, no re-hash.
 
+import path from 'node:path'
 import { Cache, noteSchemaReset } from '../cache/index.js'
 import { flagHint, seeHelp } from './help.js'
 import { splitTaskId } from '../graph/index.js'
@@ -159,6 +160,16 @@ function resolveTarget(cache: Cache, target: string): string {
 
 const fmtWhen = (ms: number): string => new Date(ms).toISOString()
 
+/** `//#task`, Turbo's root package, as the root project's id: its package.json name (D-39). */
+async function rootSpelled(root: string, target: string): Promise<string> {
+  if (!target.startsWith('//#')) return target
+  const name = await Bun.file(path.join(root, 'package.json'))
+    .json()
+    .then((j: { name?: unknown }) => j.name)
+    .catch(() => undefined)
+  return typeof name === 'string' && name !== '' ? `${name}#${target.slice(3)}` : target
+}
+
 export async function whyCmd(args: readonly string[]): Promise<number> {
   const parsed = parseWhyArgs(args)
   if (parsed.error !== undefined) throw new UserError(`vx why: ${parsed.error}`)
@@ -171,7 +182,7 @@ export async function whyCmd(args: readonly string[]): Promise<number> {
   noteSchemaReset(cache, warnToStderr)
   try {
     const db = cache.dbHandle()
-    const taskId = resolveTarget(cache, parsed.target)
+    const taskId = resolveTarget(cache, await rootSpelled(root, parsed.target))
     const runId =
       parsed.runId !== undefined
         ? (resolveRunId(db, parsed.runId, 'vx why') ?? parsed.runId)