@vzn/vx 0.0.286 → 0.0.288

package/package.json

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

package/src/cli/init.ts

@@ -99,7 +99,10 @@ export async function initCmd(args: readonly string[]): Promise<number> {
   return applyMigration({
     root,
     metas,
-    plan: migrateScripts(metas),
+    plan: migrateScripts(
+      metas,
+      metas.some((m) => m.dir === root) ? undefined : await readRootManifest(root),
+    ),
     source: 'package.json scripts',
     verb: 'vx init',
     dry: parsed.dry,
@@ -343,3 +346,13 @@ function firstTask(file: string, runner: 'turbo' | 'nx'): string {
   const first = new RegExp(`"${field}"\\s*:\\s*\\{\\s*"([^"]+)"`).exec(text)?.[1]
   return first ?? 'build'
 }
+
+/** The root package.json as an object, `{}` when unreadable or not one. */
+async function readRootManifest(root: string): Promise<Record<string, unknown>> {
+  const pj: unknown = await Bun.file(path.join(root, 'package.json'))
+    .json()
+    .catch(() => ({}))
+  return typeof pj === 'object' && pj !== null && !Array.isArray(pj)
+    ? (pj as Record<string, unknown>)
+    : {}
+}

package/src/workspace/migrate-scripts.ts

@@ -242,7 +242,15 @@ function upstreamBuildOnWorker(tasks: GeneratedTask[]): void {
   if (!at.todos.includes(todo)) at.todos.push(todo)
 }
 
-export function migrateScripts(metas: readonly ProjectMeta[]): MigrationPlan {
+/**
+ * `outside`: the root manifest when the root is no member (pnpm's and
+ * Yarn's default), whose own scripts (`lint: eslint .`) went unmapped
+ * without a word.
+ */
+export function migrateScripts(
+  metas: readonly ProjectMeta[],
+  outside?: Readonly<Record<string, unknown>>,
+): MigrationPlan {
   const projects: GeneratedProject[] = []
   const hookMemo = new Map<string, string | null>()
   // The workspace root among members: its scripts run the workspace
@@ -252,9 +260,21 @@ export function migrateScripts(metas: readonly ProjectMeta[]): MigrationPlan {
   // replaced it so (D-45). A lone package is its repo's project and maps.
   const root = metas.length > 1 ? workspaceRootOf(metas) : undefined
   const notes: string[] = []
-  if (root !== undefined) {
+  const outsideScripts = outside?.['scripts']
+  const outsideRuns =
+    typeof outsideScripts === 'object' &&
+    outsideScripts !== null &&
+    Object.values(outsideScripts).some((v) => typeof v === 'string' && v !== '')
+  const rootName =
+    root?.name ??
+    (outsideRuns
+      ? typeof outside?.['name'] === 'string'
+        ? outside['name']
+        : 'package.json'
+      : undefined)
+  if (rootName !== undefined) {
     notes.push(
-      `${root.name} (the workspace root) not mapped: its scripts run the workspace; declare its own tasks in its vx.config by hand`,
+      `${rootName} (the workspace root) not mapped: its scripts run the workspace; declare its own tasks in its vx.config by hand`,
     )
   }
   for (const meta of metas) {

package/src/workspace/workspace.ts

@@ -558,8 +558,7 @@ export async function listProjects(workspace: Workspace): Promise<ProjectMeta[]>
     }),
   )
 
-  const projects: ProjectMeta[] = []
-  const seenName = new Map<string, string>()
+  const byName = new Map<string, NonNullable<(typeof loaded)[number]>[]>()
   for (const entry of loaded) {
     if (entry === null) continue
     const { dir, pkg, configPath } = entry
@@ -575,22 +574,41 @@ export async function listProjects(workspace: Workspace): Promise<ProjectMeta[]>
       }
       continue
     }
-    const previous = seenName.get(pkg.name)
-    if (previous) {
-      // pnpm accepts two manifests of one name (sveltejs/kit's test apps,
-      // the first-five-minutes walk, 2026-09-28); vx cannot, since a
-      // project is addressed by it. Say which two, short, and the way on.
+    const group = byName.get(pkg.name)
+    if (group === undefined) byName.set(pkg.name, [entry])
+    else group.push(entry)
+  }
+  const projects: ProjectMeta[] = []
+  const shared: string[] = []
+  for (const [name, group] of byName) {
+    if (group.length === 1) {
+      const { dir, pkg, configPath } = group[0]!
+      projects.push({ name, dir, packageJson: pkg, configPath })
+      continue
+    }
+    const dirs = group.map((e) => relPosix(workspace.root, e.dir)).sort()
+    // pnpm accepts two manifests of one name (vite's playground, sveltejs/kit's
+    // test apps); vx cannot, since a project is addressed by it. Like a
+    // nameless one, a pair that declares no vx tasks is left out, so the
+    // rest of the workspace runs (vite was refused whole, 2026-10-01); one
+    // with a vx config was meant to run, and is refused with the way on.
+    if (group.some((e) => e.configPath !== null)) {
       throw new UserError(
-        `Duplicate package name "${pkg.name}" in workspace: ${[previous, dir]
-          .map((d) => relPosix(workspace.root, d))
-          .sort()
-          .join(' and ')}; ` +
+        `Duplicate package name "${name}" in workspace: ${dirs.join(' and ')}; ` +
           'vx names a project by its package name — rename one, or leave one out with a `!` pattern in the workspace globs',
       )
     }
-    seenName.set(pkg.name, dir)
-    projects.push({ name: pkg.name, dir, packageJson: pkg, configPath })
+    shared.push(`${name} (${dirs.join(', ')})`)
+  }
+  if (shared.length > 0) {
+    shared.sort()
+    const shown =
+      shared.slice(0, 2).join('; ') + (shared.length > 2 ? `; and ${shared.length - 2} more` : '')
+    process.stderr.write(
+      `vx: left out, as no project can be addressed by a name several manifests share (none has a vx config): ${shown}\n`,
+    )
   }
+
   // Code-unit order, not `localeCompare`: ICU collation cost 28 ms of a
   // 300 ms warm run at 1000 projects, and a stable deterministic order is
   // all any consumer needs.