@vzn/vx 0.0.535 → 0.0.537

package/package.json

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

package/src/exec/executor.ts

@@ -277,6 +277,12 @@ export function assertExecuteResult(
   for (const key of ['exitCode', 'durationMs']) {
     if (typeof r[key] !== 'number') fail(`${key} is ${typeof r[key]} (expected a number)`)
   }
+  // NaN passed as a number, printed `failed (exit NaN)` and failed the run
+  // history's NOT NULL write (X-11).
+  if (!Number.isInteger(r['exitCode']) || (r['exitCode'] as number) < 0)
+    fail(`exitCode is ${String(r['exitCode'])} (expected a non-negative integer)`)
+  if (!Number.isFinite(r['durationMs']) || (r['durationMs'] as number) < 0)
+    fail(`durationMs is ${String(r['durationMs'])} (expected a non-negative number)`)
   for (const key of ['stdout', 'stderr']) {
     if (typeof r[key] !== 'string') fail(`${key} is ${typeof r[key]} (expected a string)`)
   }

package/src/exec/runner.ts

@@ -155,6 +155,22 @@ function trailingCommentStart(command: string): number {
   return comment
 }
 
+/** Per line: is it a heredoc's body or terminator (`<<X` / `<<-'X'` … `X`)? */
+function heredocLines(lines: readonly string[]): boolean[] {
+  const pending: Array<{ delim: string; tabs: boolean }> = []
+  return lines.map((line) => {
+    const open = pending[0]
+    if (open !== undefined) {
+      if ((open.tabs ? line.replace(/^\t+/, '') : line) === open.delim) pending.shift()
+      return true
+    }
+    for (const m of line.matchAll(/(?<!<)<<(?!<)(-?)\s*(['"]?)([A-Za-z_]\w*)\2/g)) {
+      pending.push({ delim: m[3]!, tabs: m[1] === '-' })
+    }
+    return false
+  })
+}
+
 /**
  * The command a task runs with the args after `--` appended, shell-quoted.
  * They go before a trailing comment: appended after it, `echo args: # show`
@@ -162,6 +178,17 @@ function trailingCommentStart(command: string): number {
  */
 export function withForwardArgs(command: string, args: readonly string[] | undefined): string {
   if (!args || args.length === 0) return command
+  // A command that ends in a heredoc's body: appended to its terminator,
+  // `X FWD` closed nothing and the args never reached the command (X-12).
+  // They go on the last line that is a command, where `cat <<X FWD` is
+  // still `cat FWD` reading the heredoc.
+  const lines = command.trimEnd().split('\n')
+  const body = heredocLines(lines)
+  if (body[lines.length - 1] === true) {
+    const last = body.lastIndexOf(false)
+    const tail = lines.slice(last + 1).join('\n')
+    return `${withForwardArgs(lines.slice(0, last + 1).join('\n'), args)}\n${tail}`
+  }
   const quoted = args.map(shellQuote).join(' ')
   let comment = trailingCommentStart(command)
   if (comment < 0) {