@vzn/vx 0.0.522 → 0.0.524

package/package.json

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

package/src/cache/cache.ts

@@ -34,6 +34,7 @@
 import { Database } from 'bun:sqlite'
 import {
   accessSync,
+  chmodSync,
   closeSync,
   constants,
   existsSync,
@@ -169,38 +170,6 @@ function outOfFdsAtOpen(dbFile: string, err: unknown): UserError | undefined {
   }
 }
 
-/** Say once, on the channel the opener has, that an upgrade emptied the index. */
-export function noteSchemaReset(cache: Cache, warn: (message: string) => void): void {
-  if (cache.storeFallback !== null) {
-    warn(
-      `[vx] shared cache store ${cache.storeFallback} is not usable; entries stay in ${cache.storeDir ?? 'this workspace'}, where no other workspace hits them`,
-    )
-  }
-  if (cache.storeMoved !== null) {
-    const { from, to } = cache.storeMoved
-    warn(
-      `[vx] cache entries now live in the shared store ${to}; the ones in ${from} miss once, and \`vx cache prune\` reclaims their artifacts`,
-    )
-  }
-  if (cache.storeReset !== null) {
-    const { from, to } = cache.storeReset
-    warn(
-      `[vx] shared cache store ${cache.storeDir} re-indexed: schema ${from} → ${to} (vx version changed); its artifacts stay and are indexed again as tasks hit them`,
-    )
-  }
-  if (cache.formatChange !== null) {
-    const { from, to } = cache.formatChange
-    warn(
-      `[vx] cache format changed: ${from} → ${to} (vx version changed); every cached task misses once and re-saves, and the old entries, never read again, age out under \`vx cache prune --older-than\` or \`cacheRetention\``,
-    )
-    return
-  }
-  if (cache.schemaReset === null) return
-  const { from, to } = cache.schemaReset
-  warn(
-    `[vx] cache index reset: schema ${from} → ${to} (vx version changed); run history starts over, and each artifact is indexed again when its task next hits`,
-  )
-}
 // SCHEMA history (drop+recreate on mismatch; pre-alpha, no migrations):
 //   v20: file_hashes.content_hash (git blob OIDs).
 //   v21: dropped the unused outputs_hash column (pure-input hashing).
@@ -459,7 +428,16 @@ function ensurePrivateDir(dir: string): string | null {
   if (!st.isDirectory()) return `${dir} is not a directory`
   const uid = process.getuid?.()
   if (uid !== undefined && st.uid !== uid) return `${dir} belongs to another user`
-  if ((st.mode & 0o077) !== 0) return `${dir} is open to other users (chmod 700 it)`
+  // The user's own directory open to others (a `~/.vx` made at the
+  // default umask, 0755) is vx's to close: refusing it left the store
+  // unused on a stock macOS home (owner, 2026-10-06: "you should own it").
+  if ((st.mode & 0o077) !== 0) {
+    try {
+      chmodSync(dir, 0o700)
+    } catch (err) {
+      return `${dir} is open to other users and chmod 700 failed (${errorText(err)})`
+    }
+  }
   return null
 }
 
@@ -550,8 +528,7 @@ export class Cache implements CacheLayer {
 
   /**
    * The store this open was asked for and could not use, with why: the
-   * entries went to a store inside `cacheDir` instead. Said once by
-   * `noteSchemaReset`.
+   * entries went to a store inside `cacheDir` instead.
    */
   readonly storeFallback: string | null = null
 
@@ -561,24 +538,22 @@ export class Cache implements CacheLayer {
   /**
    * Set when THIS open found an index written by another `SCHEMA_VERSION`
    * and dropped every table. The next open sees the current version and
-   * reports null, so whoever opened first is the one that can say so —
-   * `noteSchemaReset` is that one line, at every opener that has a
-   * channel. Without it an upgrade empties the cache and the history in
-   * silence, and the all-miss run that follows looks like a bug.
+   * reports null. vx prints nothing for it: the cache is vx's to keep
+   * (owner, 2026-10-06).
    */
   readonly schemaReset: SchemaReset | null = null
 
   /**
    * Set when THIS open found entries written under another
    * `CACHE_VERSION`: the index survives, but no old key is derived again,
-   * so every cached task misses once. Reported by `noteSchemaReset`.
+   * so every cached task misses once. Not printed, like `schemaReset`.
    */
   readonly formatChange: SchemaReset | null = null
 
   /**
    * Set when THIS open found the shared store written under another
    * `SCHEMA_VERSION` and dropped its inventory; the artifacts stay and are
-   * indexed again as they hit. Reported by `noteSchemaReset`.
+   * indexed again as they hit. Never printed: the cache is vx's to keep.
    */
   readonly storeReset: SchemaReset | null = null
 

package/src/cache/index.ts

@@ -25,7 +25,6 @@ export {
   FILE_HASH_RACY_MS,
   OUTPUT_DIRS_RACY_MS,
   racyWindowMs,
-  noteSchemaReset,
   type SchemaReset,
   SCHEMA_VERSION,
 } from './cache.js'

package/src/cli/cache.ts

@@ -1,5 +1,5 @@
 import { existsSync } from 'node:fs'
-import { Cache, noteSchemaReset } from '../cache/index.js'
+import { Cache } from '../cache/index.js'
 import { flagHint, refusedWord, seeHelp } from './help.js'
 import { nearest, parseDuration, parseSize } from '../util/index.js'
 import { acquireRunLock } from '../orchestrator/index.js'
@@ -189,7 +189,6 @@ async function pruneCmd(args: readonly string[]): Promise<number> {
   // stack (an unprivileged user on a root-owned `.vx`, 2026-09-16). A dry
   // run only reads, and reads a read-only cache fine.
   if (!parsed.dryRun) cache.assertWritable()
-  noteSchemaReset(cache, warnToStderr)
   // A prune beside a run on this workspace evicts what the run has just
   // probed as hits, whose `accessed_at` bumps it has not flushed yet; the
   // run then re-runs those tasks (upstream survey, nx#36688). So a prune

package/src/cli/last.ts

@@ -5,7 +5,7 @@
 // Read-only — no config evaluation, no re-hash, no cache probe.
 
 import type { Database } from 'bun:sqlite'
-import { Cache, noteSchemaReset } from '../cache/index.js'
+import { Cache } from '../cache/index.js'
 import { formatBytes } from './format.js'
 import { flagHint, seeHelp } from './help.js'
 import {
@@ -21,7 +21,7 @@ import {
 } from '../orchestrator/index.js'
 import { formatElapsed, UserError } from '../util/index.js'
 import { findWorkspaceRoot } from '../workspace/index.js'
-import { cliCacheDir, parseCacheDirFlag, warnToStderr } from './workspace-config.js'
+import { cliCacheDir, parseCacheDirFlag } from './workspace-config.js'
 
 interface LastArgs {
   runId?: string
@@ -232,7 +232,6 @@ export async function lastCmd(args: readonly string[]): Promise<number> {
 
   const root = await findWorkspaceRoot(process.cwd())
   const cache = Cache.inspect(await cliCacheDir(root, parsed.cacheDir))
-  noteSchemaReset(cache, warnToStderr)
   try {
     const db = cache.dbHandle()
     // Nothing recorded at all is its own answer: `--failed` said "no

package/src/cli/why.ts

@@ -6,7 +6,7 @@
 // no config evaluation, no re-hash.
 
 import path from 'node:path'
-import { Cache, noteSchemaReset } from '../cache/index.js'
+import { Cache } from '../cache/index.js'
 import { flagHint, seeHelp } from './help.js'
 import { splitTaskId } from '../graph/index.js'
 import {
@@ -18,7 +18,7 @@ import {
 } from '../orchestrator/index.js'
 import { MASKED, nearMatches, printable, UserError } from '../util/index.js'
 import { findWorkspaceRoot } from '../workspace/index.js'
-import { cliCacheDir, parseCacheDirFlag, warnToStderr } from './workspace-config.js'
+import { cliCacheDir, parseCacheDirFlag } from './workspace-config.js'
 
 interface WhyArgs {
   target?: string
@@ -185,7 +185,6 @@ export async function whyCmd(args: readonly string[]): Promise<number> {
 
   const root = await findWorkspaceRoot(process.cwd())
   const cache = Cache.inspect(await cliCacheDir(root, parsed.cacheDir))
-  noteSchemaReset(cache, warnToStderr)
   try {
     const db = cache.dbHandle()
     const taskId = resolveTarget(cache, await rootSpelled(root, parsed.target))

package/src/cli/workspace-config.ts

@@ -8,7 +8,7 @@ import { existsSync } from 'node:fs'
 import path from 'node:path'
 import type { WorkspaceConfig } from '../config.js'
 import { UserError } from '../util/index.js'
-import { Cache, noteSchemaReset } from '../cache/index.js'
+import { Cache } from '../cache/index.js'
 import { discoverProjects, loadProjects, loadWorkspacePlugins } from '../orchestrator/index.js'
 import type { VxPlugin } from '../orchestrator/index.js'
 import {
@@ -147,7 +147,6 @@ export async function loadCliProjects(
           'open',
           opts.cacheDir === undefined ? ws.storeRoot : null,
         )
-  if (cache !== null) noteSchemaReset(cache, warnToStderr)
   try {
     const loaded = await loadProjects({
       workspaceRoot,

package/src/orchestrator/doctor.ts

@@ -7,7 +7,7 @@
 
 import os from 'node:os'
 import path from 'node:path'
-import { Cache, CACHE_VERSION, noteSchemaReset, SCHEMA_VERSION } from '../cache/index.js'
+import { Cache, CACHE_VERSION, SCHEMA_VERSION } from '../cache/index.js'
 import { PLUGIN_HOOKS } from '../config.js'
 import {
   cgroupCpuQuota,
@@ -154,7 +154,6 @@ async function collectWorkspaceInfo(
   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)
-  noteSchemaReset(cache, warn)
   let stats
   let orphans
   let flaky: FlakyTask[]

package/src/orchestrator/prepare.ts

@@ -12,7 +12,6 @@ import type { WorkspaceConfig } from '../config.js'
 import { beginRun, mark, nearest, UserError } from '../util/index.js'
 import {
   Cache,
-  noteSchemaReset,
   type CacheLayer,
   type CachePolicy,
   FULL_CACHE_POLICY,
@@ -287,7 +286,6 @@ export async function prepareRun(options: RunOptions, log: Logger): Promise<Prep
     storeRoot,
   )
   localCache.assertWritable()
-  noteSchemaReset(localCache, (m) => log.status(m))
   // Two digests from one read: the config-evaluation cache keys on every
   // file (a config may import a dependency), the task keys on the files no
   // plugin claims (`VxPlugin.fingerprint`).

package/src/orchestrator/run-context.ts

@@ -329,6 +329,23 @@ export interface WorkspaceIdentity {
   id: string
   /** Human name for switchers/badges: the repo (or root dir) basename. */
   name: string
+  /** The origin remote, normalized (`github.com/org/repo`); absent without one. */
+  repository?: string
+  /** The root inside its git work tree, POSIX, `.` at the top; absent outside git. */
+  path?: string
+}
+
+/** Where `root` sits in the work tree whose `.git` is nearest above it. */
+function workTreePath(root: string): string | undefined {
+  const abs = path.resolve(root)
+  for (let dir = abs; ;) {
+    if (fs.existsSync(path.join(dir, '.git'))) {
+      return path.relative(dir, abs).split(path.sep).join('/') || '.'
+    }
+    const up = path.dirname(dir)
+    if (up === dir) return undefined
+    dir = up
+  }
 }
 
 /**
@@ -375,6 +392,8 @@ export function captureWorkspaceIdentity(
   originUrl?: string | null,
 ): WorkspaceIdentity {
   const base = workspaceRoot.replace(/\/+$/, '').split('/').pop() || 'workspace'
+  const at = workTreePath(workspaceRoot)
+  const where = at === undefined ? {} : { path: at }
   try {
     let url = originUrl ?? ''
     if (originUrl === undefined) {
@@ -393,7 +412,7 @@ export function captureWorkspaceIdentity(
     if (url.length > 0) {
       const normalized = normalizeRemoteUrl(url)
       const name = normalized.split('/').pop() || base
-      return { id: xxh3hex(normalized), name }
+      return { id: xxh3hex(normalized), name, repository: normalized, ...where }
     }
   } catch {
     // git unavailable — fall through to the salt.
@@ -409,8 +428,8 @@ export function captureWorkspaceIdentity(
       fs.mkdirSync(path.dirname(saltPath), { recursive: true })
       fs.writeFileSync(saltPath, salt + '\n')
     }
-    return { id: xxh3hex(salt), name: base }
+    return { id: xxh3hex(salt), name: base, ...where }
   } catch {
-    return { id: xxh3hex(workspaceRoot), name: base }
+    return { id: xxh3hex(workspaceRoot), name: base, ...where }
   }
 }

package/src/orchestrator/run.ts

@@ -752,6 +752,8 @@ async function runOnBus(
         arch: hostContext.arch,
         workspaceId: wsIdentity.id,
         workspaceName: wsIdentity.name,
+        ...(wsIdentity.repository !== undefined ? { repository: wsIdentity.repository } : {}),
+        ...(wsIdentity.path !== undefined ? { workspacePath: wsIdentity.path } : {}),
         tags: maskTags(options.tags ?? {}),
       }
       telemetry = await subscribeTelemetry(

package/src/orchestrator/telemetry.ts

@@ -123,6 +123,10 @@ export interface RunContextRecord {
    */
   workspaceId: string
   workspaceName: string
+  /** The origin remote, normalized (`github.com/org/repo`); absent without one. Additive. */
+  repository?: string
+  /** The workspace root relative to its git work tree, `.` at the top; absent outside git. Additive. */
+  workspacePath?: string
   // git / CI / host — straight from run-context.ts.
   commitSha: string | null
   branch: string | null

package/src/workspace/migration.ts

@@ -289,7 +289,7 @@ export async function applyMigration(args: ApplyMigrationArgs): Promise<number>
     files.push({
       relPath: relPosix(root, abs),
       abs,
-      contents: renderConfigFile(source, p, verb, format),
+      contents: renderConfigFile(p, format),
     })
   }
   for (const f of plan.extraFiles) {
@@ -302,7 +302,8 @@ export async function applyMigration(args: ApplyMigrationArgs): Promise<number>
   const hasWorkspaceFile = (
     await Promise.all(WORKSPACE_CONFIG_FILENAMES.map((n) => Bun.file(path.join(root, n)).exists()))
   ).some(Boolean)
-  if (!hasWorkspaceFile) {
+  // A plan may bring its own (vx-migrate declares the plugins it detects).
+  if (!hasWorkspaceFile && !plan.extraFiles.some((f) => f.relPath === workspaceName)) {
     const abs = path.join(root, workspaceName)
     files.push({ relPath: relPosix(root, abs), abs, contents: workspaceFile(format) })
   }
@@ -550,11 +551,8 @@ function exampleConfig(format: MigrationFormat): string {
 // `import { defineWorkspace } from '@vzn/vx'` loads a SECOND copy of core
 // into every run — measured 2026-09-09 at ~17 ms on a two-package
 // workspace, a fifth of the whole run — for an identity function.
-const WORKSPACE_BODY = `// Plugins are consulted in this order; running here and caching in
-// .vx/cache are the floor under all of them, so an empty list is a
-// complete workspace. Add a remote cache, a remote executor or telemetry
-// as one entry each — those imports are the runtime ones.
-export default { plugins: [] }`
+// No explanatory comment: the file is the user's (owner, 2026-10-06).
+const WORKSPACE_BODY = `export default { plugins: [] }`
 
 function workspaceFile(format: MigrationFormat): string {
   return format === 'ts'
@@ -586,22 +584,18 @@ function renderValue(v: unknown, indent: string): string {
   return `{\n${body.join('\n')}\n${indent}}`
 }
 
-function renderConfigFile(
-  source: string,
-  p: GeneratedProject,
-  verb: string,
-  format: MigrationFormat,
-): string {
+function renderConfigFile(p: GeneratedProject, format: MigrationFormat): string {
   // A type-only import: the editor type-checks against the installed
   // package, and Bun erases it, so the config loads in a workspace that
   // runs the vx binary without the package installed. `mjs` is the same
   // object with nothing to erase.
-  const lines: string[] = [
-    `// Generated by \`${verb}\` from ${source}.${p.tasks.some((t) => t.todos.length > 0) ? ' Review the TODO(vx-migrate) comments.' : ''}`,
-  ]
+  // No "generated by" header: the file is the user's from here (owner,
+  // 2026-10-06), and each TODO(vx-migrate) sits on its own task.
+  const lines: string[] = []
   if (format === 'ts') lines.push("import type { ProjectConfig } from '@vzn/vx/config'")
   if (p.importLines.length > 0) lines.push(...p.importLines)
-  lines.push('', 'export default {')
+  if (lines.length > 0) lines.push('')
+  lines.push('export default {')
   if (p.tags !== undefined && p.tags.length > 0) lines.push(`  tags: ${renderValue(p.tags, '  ')},`)
   lines.push('  tasks: {')
   for (const t of p.tasks) {