@vzn/vx 0.0.540 → 0.0.542

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vzn/vx",
-  "version": "0.0.540",
+  "version": "0.0.542",
   "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.540",
-    "@vzn/vx-linux-arm64": "0.0.540",
-    "@vzn/vx-darwin-x64": "0.0.540",
-    "@vzn/vx-darwin-arm64": "0.0.540"
+    "@vzn/vx-linux-x64": "0.0.542",
+    "@vzn/vx-linux-arm64": "0.0.542",
+    "@vzn/vx-darwin-x64": "0.0.542",
+    "@vzn/vx-darwin-arm64": "0.0.542"
   },
   "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/select.ts

@@ -356,6 +356,14 @@ export async function resolveFilters(
     if (unmatched.length === 0 && emptyWalks.length > 0) {
       return { error: `no projects selected: ${emptyWalks.join('; ')}` }
     }
+    // Every pattern matched and an exclusion took them all back: "no
+    // projects matched filter(s): one, !one" read as a typo of `one`.
+    const negations = parsed.filter((f) => f.negate).map((f) => f.raw)
+    if (unmatched.length === 0 && negations.length > 0) {
+      return {
+        error: `no projects selected: ${negations.join(', ')} excluded every project the other filters matched`,
+      }
+    }
     // One line, not a warning per pattern and then an error saying the same:
     // the patterns are in the error, and the nearest project name is the
     // hint a typo needs.

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[]