@vzn/vx 0.0.624 → 0.0.625

package/package.json

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

package/src/bin.ts

@@ -30,8 +30,15 @@ async function main(): Promise<void> {
     // is set, and `exitOnceFlushed` exits after both streams have ended.
     process.exitCode = code
   } catch (err) {
-    const { fsRefusalHint, isFsRefusal, isOutOfFds, isUserError, maskedLine, OUT_OF_FDS_HINT } =
-      await import('./util/index.js')
+    const {
+      configErrorFrame,
+      fsRefusalHint,
+      isFsRefusal,
+      isOutOfFds,
+      isUserError,
+      maskedLine,
+      OUT_OF_FDS_HINT,
+    } = await import('./util/index.js')
     // A plugin's failure quotes what it was told (a remote's reply, a
     // header), and a config's own throw is its author's text: a secret in
     // either reached stderr whole (L-11).
@@ -44,7 +51,8 @@ async function main(): Promise<void> {
       // A message that already names the tool (`vx why: …`, thrown by a verb
       // that wants its own name in the line) is printed as it is; prefixing
       // it produced `vx: vx why: …` (walkthrough, 2026-09-04).
-      const m = err.message
+      // A config refusal names its line and shows it.
+      const m = configErrorFrame(err.message, process.cwd()) ?? err.message
       say(m.startsWith('vx ') ? `${m}\n` : `vx: ${m}\n`)
     } else if (isOutOfFds(err)) {
       say(`vx: ${err.message} — ${OUT_OF_FDS_HINT}\n`)

package/src/util/config-frame.ts

@@ -0,0 +1,90 @@
+// A config refusal pointed at its line: `vx.config.ts:7:9` (which a
+// terminal opens on click) and the source around it. Read from the
+// message the schema already writes (`<file>: tasks.<name>.<path> …`),
+// so it works for a refusal made in the config worker as for one made
+// here, and a message it cannot place prints as it always did.
+
+import { readFileSync } from 'node:fs'
+import path from 'node:path'
+
+// `<file>: tasks.<path>[:] …`, or a top-level `<file> has unknown field …`.
+const HEAD = /^(\/[^\n]*?\/vx\.config\.[cm]?[jt]s)(?:: (tasks\.[^\s:]+)(:?))? /
+
+/**
+ * The message with its file named at `line:col`, relative to `cwd`, and a
+ * frame of the source under it; undefined when the message names no
+ * config field or the field is not found in the file.
+ */
+export function configErrorFrame(message: string, cwd: string): string | undefined {
+  const head = HEAD.exec(message)
+  if (head === null) return undefined
+  const [, file, fieldPath, colon] = head as unknown as [string, string, string?, string?]
+  const rest = message.slice(head[0].length)
+  // The field the refusal is about, past the path that leads to it:
+  // `has unknown field "comand"`, or `tasks.build: \`cache\` is not allowed`.
+  const named =
+    colon === ':' ? /^`([^`]+)`/.exec(rest) : /^has (?:unknown )?field "([^"]+)"/.exec(rest)
+  const segments = [...(fieldPath?.split('.') ?? []), ...(named === null ? [] : [named[1]!])]
+  if (segments.length === 0) return undefined
+  let source: string
+  try {
+    source = readFileSync(file, 'utf8')
+  } catch {
+    return undefined
+  }
+  const at = locate(source, segments)
+  if (at === undefined) return undefined
+  const lines = source.split('\n')
+  // Relative to where the user stands, unless that means climbing out.
+  const rel = path.relative(cwd, file)
+  const shown = rel === '' || rel.startsWith('..') ? file : rel
+  const first = Math.max(1, at.line - 2)
+  const width = String(at.line).length
+  const frame: string[] = []
+  for (let n = first; n <= at.line; n++) {
+    const mark = n === at.line ? '>' : ' '
+    frame.push(`${mark} ${String(n).padStart(width)} | ${lines[n - 1]!.replace(/\t/g, '  ')}`)
+  }
+  const lead = lines[at.line - 1]!.slice(0, at.col - 1)
+    .replace(/\t/g, '  ')
+    .replace(/\S/g, ' ')
+  frame.push(`  ${' '.repeat(width)} | ${lead}^`)
+  return `${shown}:${at.line}:${at.col}${message.slice(file.length)}\n\n${frame.join('\n')}`
+}
+
+/**
+ * Where the last of `segments` is declared as a key, each one searched
+ * after the one before. A task name holds dots (`lint.oxfmt`), so the
+ * longest run of segments that names a key wins.
+ */
+function locate(
+  source: string,
+  segments: readonly string[],
+): { line: number; col: number } | undefined {
+  let pos = 0
+  let found = -1
+  let i = 0
+  while (i < segments.length) {
+    let next = -1
+    for (let j = segments.length; j > i && next < 0; j--) {
+      const name = segments.slice(i, j).join('.')
+      const re = new RegExp(`(?<![\\w$.])(['"\`]?)${escapeRe(name)}\\1\\s*:`, 'g')
+      re.lastIndex = pos
+      const m = re.exec(source)
+      if (m === null) continue
+      found = m.index + m[1]!.length
+      pos = m.index + m[0].length
+      next = j
+    }
+    if (next < 0) return undefined
+    i = next
+  }
+  if (found < 0) return undefined
+  const before = source.slice(0, found)
+  const line = before.split('\n').length
+  return { line, col: found - before.lastIndexOf('\n') }
+}
+
+function escapeRe(s: string): string {
+  return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+}

package/src/util/index.ts

@@ -18,6 +18,7 @@ export {
   notAWorkTree,
   OUT_OF_FDS_HINT,
 } from './errors.js'
+export { configErrorFrame } from './config-frame.js'
 export { xxh3, xxh3hex } from './hash.js'
 export {
   beginRun,