@vzn/vx 0.0.352 → 0.0.353

package/README.md

@@ -180,7 +180,7 @@ keep your Turbo or Nx remote cache. [Parity map](packages/vx/docs/parity.md) ·
 | Config                    | TypeScript, evaluated into the cache key  | JSON (static)                  | JSON (static)    |
 | Output ownership          | **Strict**: wiped before exec and restore | Additive (stale files survive) | Additive         |
 | Clean-tree hashing        | **Zero reads** (git index OIDs)           | git OIDs                       | re-hash / daemon |
-| Daemon required for speed | **No**                                    | Optional                       | Yes              |
+| Daemon required for speed | **No**                                    | No (`turbo run` has none)      | Yes              |
 | Per-task sandbox          | **Yes**: kernel-level, opt-in             | No                             | No               |
 | Plugin API                | **Yes**: every pipeline stage             | No                             | Yes (TS-tied)    |
 | OTel CI/CD spans          | **Yes**: `otel()` plugin, no OTel SDK     | No                             | Paid             |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vzn/vx",
-  "version": "0.0.352",
+  "version": "0.0.353",
   "description": "A fast, correct task runner and build cache for JavaScript monorepos.",
   "type": "module",
   "exports": {
@@ -21,10 +21,10 @@
     "node": ">=18"
   },
   "optionalDependencies": {
-    "@vzn/vx-linux-x64": "0.0.352",
-    "@vzn/vx-linux-arm64": "0.0.352",
-    "@vzn/vx-darwin-x64": "0.0.352",
-    "@vzn/vx-darwin-arm64": "0.0.352"
+    "@vzn/vx-linux-x64": "0.0.353",
+    "@vzn/vx-linux-arm64": "0.0.353",
+    "@vzn/vx-darwin-x64": "0.0.353",
+    "@vzn/vx-darwin-arm64": "0.0.353"
   },
   "dependencies": {
     "@anthropic-ai/sandbox-runtime": "^0.0.76"

package/src/workspace/migration.ts

@@ -8,7 +8,7 @@
 import { existsSync } from 'node:fs'
 import { unlink } from 'node:fs/promises'
 import path from 'node:path'
-import { relPosix, UserError } from '../util/index.js'
+import { executablePath, relPosix, UserError } from '../util/index.js'
 import type { ProjectMeta } from './workspace.js'
 import { loadWorkspace, unreachedHint, unreachedPackages } from './workspace.js'
 import { WORKSPACE_CONFIG_FILENAMES } from './project-loader.js'
@@ -412,14 +412,36 @@ export async function applyMigration(args: ApplyMigrationArgs): Promise<number>
     report.push('', 'no task caches yet: add the cache block a TODO shows, and a second run hits')
   }
   const installed = existsSync(path.join(root, 'node_modules', '@vzn', 'vx', 'package.json'))
-  report.push(
-    '',
-    `next: ${vxInvocation(process.env['npm_config_user_agent'], installed)} run ${firstTask} --all`,
-  )
+  // The line is the next thing to type, so it names what that run would
+  // refuse without: a git work tree (vx keys inputs on git's view) and,
+  // with no scripts mapped, a task to run.
+  const run = `${vxInvocation(process.env['npm_config_user_agent'], installed)} run ${firstTask} --all`
+  const steps = [
+    ...(inGitWorkTree(root) ? [] : ['git init']),
+    ...(empty ? [`declare a task as the example shows`] : []),
+  ]
+  report.push('', `next: ${steps.length === 0 ? run : `${steps.join(', ')}, then ${run}`}`)
   process.stdout.write(`${report.join('\n')}\n`)
   return 0
 }
 
+function inGitWorkTree(root: string): boolean {
+  try {
+    return (
+      Bun.spawnSync({
+        cmd: [executablePath('git'), 'rev-parse', '--is-inside-work-tree'],
+        cwd: root,
+        stdout: 'pipe',
+        stderr: 'ignore',
+      })
+        .stdout.toString()
+        .trim() === 'true'
+    )
+  } catch {
+    return false
+  }
+}
+
 /**
  * How the user runs vx, for the report's `next:` line. After `npx vx init`
  * or `bunx @vzn/vx init` a bare `vx` is on no PATH (the first-five-minutes