@vzn/vx 0.0.541 → 0.0.543

package/package.json

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

package/src/cache/cache.ts

@@ -636,7 +636,8 @@ export class Cache implements CacheLayer {
      * and the store's own schema is `store_meta.schema` (`matchStoreSchema`). Or
      * `null` for an index that holds its entries itself (a `cacheDir`).
      * Undefined follows the layout the index records: a reading verb, a
-     * plugin's handle.
+     * plugin's handle. An `'inspect'` open reads it only where the index
+     * records none (deleted, or never written beside a run's store).
      */
     storeRoot?: string | null,
   ) {
@@ -802,11 +803,13 @@ export class Cache implements CacheLayer {
         )?.value,
     )
     let storeDir =
-      mode === 'inspect' || storeRoot === undefined
-        ? recorded
-        : storeRoot === null
-          ? undefined
-          : storeRoot
+      mode === 'inspect'
+        ? (recorded ?? (typeof storeRoot === 'string' ? storeRoot : undefined))
+        : storeRoot === undefined
+          ? recorded
+          : storeRoot === null
+            ? undefined
+            : storeRoot
     if (storeDir !== undefined && mode === 'open' && this.writeBlocked === null) {
       const blocked = storeBlocked(storeDir, typeof storeRoot === 'string' ? storeRoot : null)
       if (blocked !== null) {

package/src/cli/cache.ts

@@ -4,7 +4,12 @@ import { flagHint, refusedWord, seeHelp } from './help.js'
 import { nearest, parseDuration, parseSize } from '../util/index.js'
 import { acquireRunLock } from '../orchestrator/index.js'
 import { findWorkspaceRoot } from '../workspace/index.js'
-import { cliCacheDir, parseCacheDirFlag, warnToStderr } from './workspace-config.js'
+import {
+  cliCacheDir,
+  loadCliWorkspace,
+  parseCacheDirFlag,
+  warnToStderr,
+} from './workspace-config.js'
 import { formatBytes } from './format.js'
 
 // parseSize moved to `util` (the orchestrator's resource resolver needs it
@@ -90,7 +95,7 @@ export function parsePruneArgs(args: readonly string[]): PruneArgs {
       // the deliberate way to do it.
       if (ms === 0) {
         return {
-          error: `--older-than 0 would evict every entry — delete the cache directory instead`,
+          error: `--older-than 0 would evict every entry — to clear the cache, delete the cache store \`vx info\` names`,
         }
       }
       out.olderThanMs = Date.now() - ms
@@ -103,7 +108,7 @@ export function parsePruneArgs(args: readonly string[]): PruneArgs {
       if (bytes === null) return { error: `invalid size: ${v} (e.g. 500M, 1G)` }
       if (bytes === 0) {
         return {
-          error: `--max-size 0 would evict every entry — delete the cache directory instead`,
+          error: `--max-size 0 would evict every entry — to clear the cache, delete the cache store \`vx info\` names`,
         }
       }
       // A bare number is bytes to `parseSize` (a computed size needs that),
@@ -161,14 +166,20 @@ async function pruneCmd(args: readonly string[]): Promise<number> {
   // operate on the same directory or prune silently no-ops against the
   // wrong path.
   // A dry run only reads: it never resets the index (item 896).
-  const dir = await cliCacheDir(root, parsed.cacheDir)
+  // The store `vx run` keeps entries in (`~/.vx/<id>/cache`): with the
+  // index deleted, a prune followed nothing and said 0 while every entry
+  // stayed restorable (X-17).
+  let dir: string
+  let storeRoot: string | null = null
+  if (parsed.cacheDir !== undefined) dir = await cliCacheDir(root, parsed.cacheDir)
+  else ({ cacheDir: dir, storeRoot } = await loadCliWorkspace(root))
   // A workspace that never ran has nothing to prune, and opening the cache
   // to find that out made it: `.vx/cache` with a database and a
   // `.gitignore`, where item 900 had held the dry run to making nothing
   // (and a read-only checkout was refused as unwritable instead).
   const dry = parsed.dryRun === true
   const json = parsed.format === 'json'
-  if (!existsSync(dir)) {
+  if (!existsSync(dir) && (storeRoot === null || !existsSync(storeRoot))) {
     printPruned({ evicted: 0, bytesFreed: 0, orphans: 0, orphanBytes: 0 }, dry, json)
     return 0
   }
@@ -182,7 +193,10 @@ async function pruneCmd(args: readonly string[]): Promise<number> {
       return 0
     }
   }
-  const cache = parsed.dryRun === true ? Cache.inspect(dir) : new Cache(dir)
+  const cache =
+    parsed.dryRun === true
+      ? new Cache(dir, undefined, undefined, undefined, 'inspect', storeRoot)
+      : new Cache(dir, undefined, root, undefined, 'open', storeRoot)
   // A prune deletes rows and artifacts; a cache this user cannot write is
   // refused up front with the directory named, as a run refuses it, rather
   // than dying in the first DELETE with SQLite's "readonly database" and a

package/src/cli/why.ts

@@ -18,6 +18,7 @@ import {
 } from '../orchestrator/index.js'
 import { MASKED, nearMatches, printable, UserError } from '../util/index.js'
 import { findWorkspaceRoot } from '../workspace/index.js'
+import { findCwdProject } from './select.js'
 import { cliCacheDir, parseCacheDirFlag } from './workspace-config.js'
 
 interface WhyArgs {
@@ -127,9 +128,14 @@ function suggest(query: string, ids: readonly string[]): string {
 /**
  * Resolve a positional target to a full `project#task` id against the runs
  * table. A `pkg#task` form is used as-is; a bare task name matches every
- * project that ran it — unique → resolved, several → error listing them.
+ * project that ran it — unique → resolved, several → the project the cwd
+ * sits in, as `vx run build` there picks (X-18), else an error listing them.
  */
-function resolveTarget(cache: Cache, target: string): string {
+async function resolveTarget(
+  cache: Cache,
+  target: string,
+  cwdProject: () => Promise<string | null>,
+): Promise<string> {
   const db = cache.dbHandle()
   if (target.includes('#')) {
     // An exact id needs one row, and its newest is where a scan from the
@@ -151,6 +157,8 @@ function resolveTarget(cache: Cache, target: string): string {
   const matches = ids.filter((id) => id.endsWith(`#${target}`))
   if (matches.length === 1) return matches[0]!
   if (matches.length > 1) {
+    const here = await cwdProject()
+    if (here !== null && matches.includes(`${here}#${target}`)) return `${here}#${target}`
     throw new UserError(
       `vx why: "${target}" ran in ${matches.length} projects — pick one:\n` +
         matches.map((m) => `  ${m}`).join('\n'),
@@ -187,11 +195,19 @@ export async function whyCmd(args: readonly string[]): Promise<number> {
   const cache = Cache.inspect(await cliCacheDir(root, parsed.cacheDir))
   try {
     const db = cache.dbHandle()
-    const taskId = resolveTarget(cache, await rootSpelled(root, parsed.target))
-    const runId =
-      parsed.runId !== undefined
-        ? (resolveRunId(db, parsed.runId, 'vx why') ?? parsed.runId)
-        : latestRunId(db, taskId)
+    const taskId = await resolveTarget(cache, await rootSpelled(root, parsed.target), () =>
+      findCwdProject(process.cwd()),
+    )
+    let runId: string | null
+    if (parsed.runId !== undefined) {
+      runId = resolveRunId(db, parsed.runId, 'vx why')
+      // An unknown id read as a known run missing the task (X-18).
+      if (runId === null) {
+        throw new UserError(
+          `vx why: no recorded run ${parsed.runId} (vx last --list shows recent runs)`,
+        )
+      }
+    } else runId = latestRunId(db, taskId)
 
     if (runId === null) {
       // Runs exist (resolveTarget passed) but predate run ids — fall back to
@@ -245,7 +261,10 @@ export async function whyCmd(args: readonly string[]): Promise<number> {
       // The key moved and the diff says by what: the verdict names it, so
       // an env-only change reads as one line, not "inputs differ" above a
       // table to scan.
-      const moved = diff.entries.map((e) => `${e.kind} ${printable(e.name)}`)
+      // The config component is kind and name `config`: it read "config config".
+      const moved = diff.entries.map((e) =>
+        e.name === e.kind ? e.kind : `${e.kind} ${printable(e.name)}`,
+      )
       lines.push(
         `  verdict    ${
           why.hashChanged === true && moved.length > 0

package/src/orchestrator/doctor.ts

@@ -153,7 +153,7 @@ async function collectWorkspaceInfo(
       : path.resolve(cwd, opts.cacheDir)
   const metas = await discoverProjects(await loadWorkspace(root, reads), plugins, cacheDir, warn)
   const storeRoot = opts.cacheDir === undefined ? resolveStoreRoot(root, workspaceConfig) : null
-  const cache = Cache.inspect(cacheDir)
+  const cache = new Cache(cacheDir, undefined, undefined, undefined, 'inspect', storeRoot)
   let stats
   let orphans
   let flaky: FlakyTask[]