@vzn/vx 0.0.576 → 0.0.578

package/package.json

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

package/src/cache/git-inputs.ts

@@ -12,6 +12,7 @@ import {
   executablePath,
   gitSpawnRefusal,
   isInstalledPath,
+  notAWorkTree,
   xxh3hex,
 } from '../util/index.js'
 import { FILE_HASH_RACY_MS, racyWindowMs } from './layer.js'
@@ -457,11 +458,7 @@ export function runGitLsFiles(cwd: string): GitLsResult {
   if (proc.exitCode !== 0) {
     // Exit 128 = not a git work tree; other non-zero = git failure.
     // Either way we can't enumerate inputs reliably.
-    const stderr = new TextDecoder().decode(proc.stderr).trim()
-    throw new UserError(
-      `vx requires git: ${cwd} is not inside a git work tree. ` +
-        `Run 'git init' in your workspace root.${stderr ? ` (git: ${stderr})` : ''}`,
-    )
+    throw notAWorkTree(cwd, new TextDecoder().decode(proc.stderr).trim())
   }
   const { text, undecodable } = decodeGitZ(proc.stdout)
   const parsed = parseLsFilesOutput(text.length === 0 ? [] : text.split('\0'), undecodable)

package/src/util/errors.ts

@@ -98,6 +98,18 @@ export function gitSpawnRefusal(cwd: string): UserError {
   )
 }
 
+/**
+ * The one refusal for a directory git does not track, wherever vx needed
+ * it: `--affected` named a missing base there, as a shallow clone, while
+ * a plain run already said this (X-52).
+ */
+export function notAWorkTree(cwd: string, stderr = ''): UserError {
+  return new UserError(
+    `vx requires git: ${cwd} is not inside a git work tree. ` +
+      `Run 'git init' in your workspace root.${stderr ? ` (git: ${stderr})` : ''}`,
+  )
+}
+
 export const TMPDIR_HINT = 'point TMPDIR at a writable directory'
 
 /**

package/src/util/index.ts

@@ -15,6 +15,7 @@ export {
   gitSpawnRefusal,
   isExecutableMissing,
   isOutOfFds,
+  notAWorkTree,
   OUT_OF_FDS_HINT,
 } from './errors.js'
 export { xxh3, xxh3hex } from './hash.js'

package/src/workspace/affected.ts

@@ -15,6 +15,7 @@ import {
   gitSpawnRefusal,
   isExecutableMissing,
   isInstalledPath,
+  notAWorkTree,
   relPosix,
 } from '../util/index.js'
 import { LOCKFILE_NAME } from './lockfile.js'
@@ -649,6 +650,8 @@ export async function defaultAffectedBase(workspaceRoot: string): Promise<string
   const trunk = trunkBase(workspaceRoot)
   if (trunk !== undefined) return trunk
   if (revParse(workspaceRoot, 'HEAD~1') === undefined) {
+    const noHistory = noHistoryRefusal(workspaceRoot)
+    if (noHistory !== undefined) throw noHistory
     throw new UserError(
       '--affected has no base here: origin/HEAD is not set (or names a branch that is gone) and HEAD has no parent to compare ' +
         'with — a shallow clone? Fetch history (actions/checkout: fetch-depth: 0) or name the ' +
@@ -658,6 +661,24 @@ export async function defaultAffectedBase(workspaceRoot: string): Promise<string
   return 'HEAD~1'
 }
 
+/**
+ * Why a base cannot resolve before any ref is to blame: no work tree, or
+ * no commit yet. Asked only once a base has failed, so a run that finds
+ * one spawns nothing more (X-52).
+ */
+function noHistoryRefusal(workspaceRoot: string): UserError | undefined {
+  const tree = spawnGitSync(['rev-parse', '--is-inside-work-tree'], workspaceRoot, 'pipe')
+  if (tree.exitCode !== 0) {
+    return notAWorkTree(workspaceRoot, new TextDecoder().decode(tree.stderr).trim())
+  }
+  if (revParse(workspaceRoot, 'HEAD') === undefined) {
+    return new UserError(
+      '--affected has no base here: this repository has no commit yet. Commit first, or run without --affected.',
+    )
+  }
+  return undefined
+}
+
 const TRUNKS = ['origin/main', 'origin/master', 'main', 'master']
 
 /** The first of `TRUNKS` that exists and is not HEAD's commit, in one spawn. */
@@ -752,6 +773,8 @@ async function verifyRef(workspaceRoot: string, ref: string): Promise<void> {
   // 1 gets the ref message; anything else surfaces what git actually said.
   const stderr = new TextDecoder().decode(proc.stderr).trim()
   if (proc.exitCode !== 1) {
+    const noHistory = noHistoryRefusal(workspaceRoot)
+    if (noHistory !== undefined) throw noHistory
     throw new UserError(
       `git rev-parse failed (exit ${proc.exitCode}) in ${workspaceRoot}` +
         (stderr.length > 0 ? `: ${stderr}` : ''),