@vzn/vx 0.0.442 → 0.0.444

package/package.json

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

package/src/cli/index.ts

@@ -167,6 +167,17 @@ export async function run(argv: readonly string[]): Promise<number> {
       // declaring `mcp` read as a plain unknown command, and `vx mcp`
       // before the plugin was declared said nothing about the file that
       // would declare it (2026-09-20).
+      // A word that opens with a dash is a flag, and vx itself takes only
+      // --help and --version: "unknown command: --bogus" named the wrong
+      // thing (M-60).
+      if (command.startsWith('-')) {
+        // `-v` / `-V` is another tool's version flag, far from both names.
+        const flag = /^-v$/i.test(command) ? '--version' : nearest(command, ['--help', '--version'])
+        process.stderr.write(
+          `vx: unknown flag: ${command}${flag === undefined ? '' : ` (did you mean ${flag}?)`}; a verb's flags follow the verb (see \`vx help\`)\n`,
+        )
+        return 1
+      }
       const declaredVerbs =
         resolved !== null && 'declaredVerbs' in resolved ? resolved.declaredVerbs : []
       const guess = didYouMeanVerb(command, declaredVerbs)

package/src/cli/init.ts

@@ -98,6 +98,7 @@ export async function initCmd(args: readonly string[]): Promise<number> {
   if (await Bun.file(path.join(root, 'nx.json')).exists()) {
     return adopt(root, 'nx', 'nx.json', parsed)
   }
+  const unmapped = namelessNotes(root, nameless)
   return applyMigration({
     root,
     metas,
@@ -108,10 +109,8 @@ export async function initCmd(args: readonly string[]): Promise<number> {
     ),
     source: 'package.json scripts',
     verb: 'vx init',
-    notes: [
-      ...(await unreadWorkspaces(root, workspace.packageGlobs)),
-      ...namelessNotes(root, nameless),
-    ],
+    notes: [...(await unreadWorkspaces(root, workspace.packageGlobs)), ...unmapped],
+    unmapped: unmapped.length > 0,
     dry: parsed.dry,
     force: parsed.force,
     init: true,

package/src/orchestrator/telemetry.ts

@@ -9,8 +9,8 @@
 // folded in — instead of each re-deriving an ad-hoc shape from the raw,
 // rendering-oriented `WireEvent` stream.
 //
-// A sink is observe-only BY CONSTRUCTION: its only input is an immutable
-// record; its `TelemetryContext` carries read-only metadata and NO mutable
+// A sink is observe-only BY CONSTRUCTION: its only input is a plain-data
+// record (one object every sink receives, not frozen); its `TelemetryContext` carries read-only metadata and NO mutable
 // run handle (no bus, no Cache, no RunRequest). There is no API path from a
 // sink back into scheduling/caching/exec — telemetry provably cannot change
 // what or how tasks run. Contrast `cache`/`executor`, which return objects

package/src/workspace/migration.ts

@@ -234,6 +234,12 @@ export interface ApplyMigrationArgs {
   init?: boolean
   /** Report lines printed under the source line (e.g. "turbo.json found and not read"). */
   notes?: readonly string[]
+  /**
+   * Scripts exist but no project can carry them (a member without a
+   * `name`): the empty report said "no package.json scripts" of a repo full
+   * of them (M-59).
+   */
+  unmapped?: boolean
   /**
    * `ts` (default) writes `vx.config.ts` with the type-only import and
    * `satisfies`; `mjs` writes `vx.config.mjs` — the same object, untyped —
@@ -388,7 +394,9 @@ export async function applyMigration(args: ApplyMigrationArgs): Promise<number>
     )
   } else if (empty) {
     report.push(
-      `${verb}: no package.json scripts to turn into tasks.`,
+      args.unmapped === true
+        ? `${verb}: no package.json scripts became tasks.`
+        : `${verb}: no package.json scripts to turn into tasks.`,
       ...[...noMembers, ...(args.notes ?? [])].map((n) => `note: ${n}`),
       hasWorkspaceFile
         ? `${workspaceName} already exists.`