@visulima/task-runner 1.0.0-alpha.5 → 1.0.0-alpha.7

package/dist/types.d.ts

@@ -12,6 +12,32 @@ export interface TaskTarget {
 /**
  * Represents a single task to be executed.
  */
+/**
+ * Scheduling priority hint. The scheduler picks higher-priority tasks
+ * out of the ready-queue first; ties fall through to the graph-derived
+ * signals (dependent count, project depth).
+ *
+ * Use `"high"` for long-running leaves you want to kick off early
+ * (integration tests, e2e suites) so their wall-clock overlaps with
+ * the main build phase. Use `"low"` for work you don't mind deferring
+ * (linters, coverage uploads) when faster tasks contend for slots.
+ */
+export type TaskPriority = "high" | "low" | "normal";
+/**
+ * A single entry in a task's `outputs` list.
+ *
+ * - `string` — a literal path *or* a glob pattern relative to the
+ *   workspace root. Prefix with `!` to exclude files the positive
+ *   patterns would otherwise include (e.g. `"!dist/cache/**"`).
+ * - `{ auto: true }` — use whatever files the task actually wrote
+ *   during execution (resolved from the file-access tracker). Lets
+ *   authors who don't know their exact output layout cache results
+ *   without listing every path. Silently behaves as "no outputs" when
+ *   tracking isn't active for this task.
+ */
+export type OutputSpec = string | {
+    auto: true;
+};
 export interface Task {
     /** Whether this task is eligible for caching */
     cache?: boolean;
@@ -21,12 +47,22 @@ export interface Task {
     hashDetails?: TaskHashDetails;
     /** Unique identifier for the task, typically "project:target:configuration" */
     id: string;
-    /** Output file paths produced by this task */
-    outputs: string[];
+    /**
+     * Output patterns this task produces. Each entry is either a
+     * literal path, a glob (`"dist/**"`), a negative glob
+     * (`"!dist/cache/**"`), or `{ auto: true }` to pick up whatever
+     * files the task wrote during execution.
+     */
+    outputs: OutputSpec[];
     /** Overrides/extra options passed to the task */
     overrides: Record<string, unknown>;
     /** Whether this task supports parallel execution */
     parallelism?: boolean;
+    /**
+     * Explicit scheduling priority. Outranks the scheduler's
+     * graph-derived heuristics. Defaults to `"normal"` when absent.
+     */
+    priority?: TaskPriority;
     /** The project root directory */
     projectRoot?: string;
     /** The target this task executes */
@@ -66,8 +102,23 @@ export type TaskStatus = "success" | "failure" | "skipped" | "local-cache" | "lo
 export interface TaskResult {
     /** The exit code, if applicable */
     code?: number;
+    /**
+     * Set when auto-fingerprint tracking was attempted for this task but
+     * returned zero workspace accesses — usually a static binary on
+     * macOS/Windows, where the Node preload can't attach. Caching is
+     * skipped to avoid persisting an empty fingerprint that would
+     * produce false cache hits on every subsequent run.
+     */
+    emptyFingerprint?: boolean;
     /** The end time of the task */
     endTime?: number;
+    /**
+     * Set when the task modified one or more of its own tracked input
+     * files during execution. Caching is skipped in this case — the
+     * fingerprint captured before the run would mismatch the post-run
+     * contents and produce false cache hits on subsequent runs.
+     */
+    selfModified?: boolean;
     /** The start time of the task */
     startTime?: number;
     status: TaskStatus;
@@ -145,11 +196,30 @@ export interface TargetDependencyConfig {
  * Defines an input for cache invalidation.
  */
 export type InputDefinition = FileSetInput | RuntimeInput | EnvironmentInput | ExternalDependencyInput;
+/**
+ * Controls how a glob pattern is anchored.
+ * - "package" (default): pattern is resolved relative to the project root
+ * - "workspace": pattern is resolved relative to the workspace root
+ */
+export type FileSetBase = "package" | "workspace";
 /**
  * An input based on file patterns.
+ *
+ * `fileset` may be a bare glob string (package-root relative) or an object
+ * form `{ pattern, base }` to anchor explicitly to the workspace root.
+ * Negation (`!` prefix) works in both forms.
  */
 export interface FileSetInput {
-    fileset: string;
+    fileset: FileSetPattern | string;
+}
+/**
+ * Object form of a fileset pattern, for anchoring to the workspace root.
+ */
+export interface FileSetPattern {
+    /** Anchor for the pattern. */
+    base: FileSetBase;
+    /** Glob pattern (may start with `!` for negation). */
+    pattern: string;
 }
 /**
  * An input based on a runtime command.
@@ -311,6 +381,14 @@ export interface NamedInputs {
  * Configuration for the task runner.
  */
 export interface TaskRunnerOptions {
+    /**
+     * Scan each task's resolved command text for `$VAR`/`${VAR}`
+     * references and automatically fingerprint those env vars. Catches
+     * tasks like `curl ${VERCEL_URL}/api` where the user forgot to
+     * declare the reference in `envVars`/`globalEnv`.
+     * @default false
+     */
+    autoEnvVars?: boolean;
     /**
      * Enable auto-fingerprinting mode (Vite Task-style).
      * When enabled, the task runner automatically tracks which files
@@ -374,12 +452,37 @@ export interface TaskRunnerOptions {
      * forcing a full rebuild. This matches Turborepo's `globalDependencies`.
      */
     globalInputs?: string[];
+    /**
+     * When `true`, file hashes are cached in a persistent mtime+size
+     * indexed snapshot under `node_modules/.cache/task-runner/`. On
+     * subsequent runs, unchanged files skip content re-reads — cuts
+     * cold-cache fingerprint time dramatically on large workspaces.
+     *
+     * Changed or new files still get full content hashing. Safe to
+     * leave on by default; overhead when nothing matches is a single
+     * `stat` call per file.
+     * @default false
+     */
+    incrementalFileHashing?: boolean;
     /** Maximum age of cache entries in milliseconds */
     maxCacheAge?: number;
     /** Maximum cache size (e.g., "1GB") */
     maxCacheSize?: string;
     /** Named inputs for cache invalidation */
     namedInputs?: NamedInputs;
+    /**
+     * When `true`, the cache directory is partitioned by a hash of
+     * the resolved `globalEnv` values. Changing a globalEnv var moves
+     * cache writes into a new namespace; rolling it back reuses the
+     * old namespace and its hits. Without this option, any globalEnv
+     * change silently busts every cached entry.
+     *
+     * Keep disabled when globalEnv is stable across runs — the extra
+     * path depth offers no value, and misconfigured namespaces can
+     * hide stale hits.
+     * @default false
+     */
+    namespaceByGlobalEnv?: boolean;
     /** Maximum number of parallel tasks */
     parallel?: number | boolean;
     /**
@@ -614,8 +717,39 @@ export interface ConcurrentRunResult {
 export interface LifeCycleInterface {
     endCommand?: () => void;
     endTasks?: (taskResults: TaskResult[]) => void;
+    /**
+     * Called when a running task emits data on stderr, in the order the
+     * data arrives. Executors that support streaming output (`vis run`'s
+     * concurrent executor) forward chunks here verbatim. Executors that
+     * only buffer full output (e.g. the simple test executor) skip this
+     * hook — rely on `printTaskTerminalOutput` for the final dump.
+     *
+     * Handlers should be non-blocking; the orchestrator doesn't await.
+     */
+    onTaskStderr?: (task: Task, chunk: string) => void;
+    /**
+     * Called when a running task emits data on stdout, in the order the
+     * data arrives. See {@link LifeCycleInterface.onTaskStderr} for
+     * semantics — same contract, different stream.
+     */
+    onTaskStdout?: (task: Task, chunk: string) => void;
     /** Called when a cache miss occurs with diagnostic information */
     printCacheMiss?: (task: Task, reasons: string) => void;
+    /**
+     * Called when caching was skipped because auto-fingerprint tracking
+     * came back empty — a signal that the tracker (strace or Node
+     * preload) couldn't observe the task's file access, typically
+     * because it's a static binary on a platform without strace.
+     * `reason` is a short human-readable diagnostic.
+     */
+    printEmptyFingerprintWarning?: (task: Task, reason: string) => void;
+    /**
+     * Called when caching is skipped because the task modified one or
+     * more of its own tracked inputs. `modifiedFiles` lists the
+     * workspace-relative paths that changed between pre- and
+     * post-execution hashes.
+     */
+    printSelfModifyingSkip?: (task: Task, modifiedFiles: string[]) => void;
     printTaskTerminalOutput?: (task: Task, status: TaskStatus, terminalOutput: string) => void;
     scheduleTask?: (task: Task) => void;
     startCommand?: () => void;

package/index.js

@@ -82,12 +82,12 @@ function requireNative() {
                 const binding = require("@visulima/task-runner-binding-android-arm64");
                 const bindingPackageVersion = require("@visulima/task-runner-binding-android-arm64/package.json").version;
                 if (
-                    bindingPackageVersion !== "1.0.0-alpha.3" &&
+                    bindingPackageVersion !== "1.0.0-alpha.5" &&
                     process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
                     process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== "0"
                 ) {
                     throw new Error(
-                        `Native binding package version mismatch, expected 1.0.0-alpha.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+                        `Native binding package version mismatch, expected 1.0.0-alpha.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
                     );
                 }
                 return binding;
@@ -104,12 +104,12 @@ function requireNative() {
                 const binding = require("@visulima/task-runner-binding-android-arm-eabi");
                 const bindingPackageVersion = require("@visulima/task-runner-binding-android-arm-eabi/package.json").version;
                 if (
-                    bindingPackageVersion !== "1.0.0-alpha.3" &&
+                    bindingPackageVersion !== "1.0.0-alpha.5" &&
                     process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
                     process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== "0"
                 ) {
                     throw new Error(
-                        `Native binding package version mismatch, expected 1.0.0-alpha.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+                        `Native binding package version mismatch, expected 1.0.0-alpha.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
                     );
                 }
                 return binding;
@@ -131,12 +131,12 @@ function requireNative() {
                     const binding = require("@visulima/task-runner-binding-win32-x64-gnu");
                     const bindingPackageVersion = require("@visulima/task-runner-binding-win32-x64-gnu/package.json").version;
                     if (
-                        bindingPackageVersion !== "1.0.0-alpha.3" &&
+                        bindingPackageVersion !== "1.0.0-alpha.5" &&
                         process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
                         process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== "0"
                     ) {
                         throw new Error(
-                            `Native binding package version mismatch, expected 1.0.0-alpha.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+                            `Native binding package version mismatch, expected 1.0.0-alpha.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
                         );
                     }
                     return binding;
@@ -153,12 +153,12 @@ function requireNative() {
                     const binding = require("@visulima/task-runner-binding-win32-x64-msvc");
                     const bindingPackageVersion = require("@visulima/task-runner-binding-win32-x64-msvc/package.json").version;
                     if (
-                        bindingPackageVersion !== "1.0.0-alpha.3" &&
+                        bindingPackageVersion !== "1.0.0-alpha.5" &&
                         process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
                         process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== "0"
                     ) {
                         throw new Error(
-                            `Native binding package version mismatch, expected 1.0.0-alpha.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+                            `Native binding package version mismatch, expected 1.0.0-alpha.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
                         );
                     }
                     return binding;
@@ -176,12 +176,12 @@ function requireNative() {
                 const binding = require("@visulima/task-runner-binding-win32-ia32-msvc");
                 const bindingPackageVersion = require("@visulima/task-runner-binding-win32-ia32-msvc/package.json").version;
                 if (
-                    bindingPackageVersion !== "1.0.0-alpha.3" &&
+                    bindingPackageVersion !== "1.0.0-alpha.5" &&
                     process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
                     process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== "0"
                 ) {
                     throw new Error(
-                        `Native binding package version mismatch, expected 1.0.0-alpha.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+                        `Native binding package version mismatch, expected 1.0.0-alpha.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
                     );
                 }
                 return binding;
@@ -198,12 +198,12 @@ function requireNative() {
                 const binding = require("@visulima/task-runner-binding-win32-arm64-msvc");
                 const bindingPackageVersion = require("@visulima/task-runner-binding-win32-arm64-msvc/package.json").version;
                 if (
-                    bindingPackageVersion !== "1.0.0-alpha.3" &&
+                    bindingPackageVersion !== "1.0.0-alpha.5" &&
                     process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
                     process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== "0"
                 ) {
                     throw new Error(
-                        `Native binding package version mismatch, expected 1.0.0-alpha.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+                        `Native binding package version mismatch, expected 1.0.0-alpha.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
                     );
                 }
                 return binding;
@@ -222,9 +222,9 @@ function requireNative() {
         try {
             const binding = require("@visulima/task-runner-binding-darwin-universal");
             const bindingPackageVersion = require("@visulima/task-runner-binding-darwin-universal/package.json").version;
-            if (bindingPackageVersion !== "1.0.0-alpha.3" && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== "0") {
+            if (bindingPackageVersion !== "1.0.0-alpha.5" && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== "0") {
                 throw new Error(
-                    `Native binding package version mismatch, expected 1.0.0-alpha.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+                    `Native binding package version mismatch, expected 1.0.0-alpha.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
                 );
             }
             return binding;
@@ -241,12 +241,12 @@ function requireNative() {
                 const binding = require("@visulima/task-runner-binding-darwin-x64");
                 const bindingPackageVersion = require("@visulima/task-runner-binding-darwin-x64/package.json").version;
                 if (
-                    bindingPackageVersion !== "1.0.0-alpha.3" &&
+                    bindingPackageVersion !== "1.0.0-alpha.5" &&
                     process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
                     process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== "0"
                 ) {
                     throw new Error(
-                        `Native binding package version mismatch, expected 1.0.0-alpha.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+                        `Native binding package version mismatch, expected 1.0.0-alpha.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
                     );
                 }
                 return binding;
@@ -263,12 +263,12 @@ function requireNative() {
                 const binding = require("@visulima/task-runner-binding-darwin-arm64");
                 const bindingPackageVersion = require("@visulima/task-runner-binding-darwin-arm64/package.json").version;
                 if (
-                    bindingPackageVersion !== "1.0.0-alpha.3" &&
+                    bindingPackageVersion !== "1.0.0-alpha.5" &&
                     process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
                     process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== "0"
                 ) {
                     throw new Error(
-                        `Native binding package version mismatch, expected 1.0.0-alpha.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+                        `Native binding package version mismatch, expected 1.0.0-alpha.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
                     );
                 }
                 return binding;
@@ -289,12 +289,12 @@ function requireNative() {
                 const binding = require("@visulima/task-runner-binding-freebsd-x64");
                 const bindingPackageVersion = require("@visulima/task-runner-binding-freebsd-x64/package.json").version;
                 if (
-                    bindingPackageVersion !== "1.0.0-alpha.3" &&
+                    bindingPackageVersion !== "1.0.0-alpha.5" &&
                     process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
                     process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== "0"
                 ) {
                     throw new Error(
-                        `Native binding package version mismatch, expected 1.0.0-alpha.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+                        `Native binding package version mismatch, expected 1.0.0-alpha.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
                     );
                 }
                 return binding;
@@ -311,12 +311,12 @@ function requireNative() {
                 const binding = require("@visulima/task-runner-binding-freebsd-arm64");
                 const bindingPackageVersion = require("@visulima/task-runner-binding-freebsd-arm64/package.json").version;
                 if (
-                    bindingPackageVersion !== "1.0.0-alpha.3" &&
+                    bindingPackageVersion !== "1.0.0-alpha.5" &&
                     process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
                     process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== "0"
                 ) {
                     throw new Error(
-                        `Native binding package version mismatch, expected 1.0.0-alpha.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+                        `Native binding package version mismatch, expected 1.0.0-alpha.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
                     );
                 }
                 return binding;
@@ -338,12 +338,12 @@ function requireNative() {
                     const binding = require("@visulima/task-runner-binding-linux-x64-musl");
                     const bindingPackageVersion = require("@visulima/task-runner-binding-linux-x64-musl/package.json").version;
                     if (
-                        bindingPackageVersion !== "1.0.0-alpha.3" &&
+                        bindingPackageVersion !== "1.0.0-alpha.5" &&
                         process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
                         process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== "0"
                     ) {
                         throw new Error(
-                            `Native binding package version mismatch, expected 1.0.0-alpha.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+                            `Native binding package version mismatch, expected 1.0.0-alpha.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
                         );
                     }
                     return binding;
@@ -360,12 +360,12 @@ function requireNative() {
                     const binding = require("@visulima/task-runner-binding-linux-x64-gnu");
                     const bindingPackageVersion = require("@visulima/task-runner-binding-linux-x64-gnu/package.json").version;
                     if (
-                        bindingPackageVersion !== "1.0.0-alpha.3" &&
+                        bindingPackageVersion !== "1.0.0-alpha.5" &&
                         process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
                         process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== "0"
                     ) {
                         throw new Error(
-                            `Native binding package version mismatch, expected 1.0.0-alpha.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+                            `Native binding package version mismatch, expected 1.0.0-alpha.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
                         );
                     }
                     return binding;
@@ -384,12 +384,12 @@ function requireNative() {
                     const binding = require("@visulima/task-runner-binding-linux-arm64-musl");
                     const bindingPackageVersion = require("@visulima/task-runner-binding-linux-arm64-musl/package.json").version;
                     if (
-                        bindingPackageVersion !== "1.0.0-alpha.3" &&
+                        bindingPackageVersion !== "1.0.0-alpha.5" &&
                         process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
                         process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== "0"
                     ) {
                         throw new Error(
-                            `Native binding package version mismatch, expected 1.0.0-alpha.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+                            `Native binding package version mismatch, expected 1.0.0-alpha.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
                         );
                     }
                     return binding;
@@ -406,12 +406,12 @@ function requireNative() {
                     const binding = require("@visulima/task-runner-binding-linux-arm64-gnu");
                     const bindingPackageVersion = require("@visulima/task-runner-binding-linux-arm64-gnu/package.json").version;
                     if (
-                        bindingPackageVersion !== "1.0.0-alpha.3" &&
+                        bindingPackageVersion !== "1.0.0-alpha.5" &&
                         process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
                         process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== "0"
                     ) {
                         throw new Error(
-                            `Native binding package version mismatch, expected 1.0.0-alpha.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+                            `Native binding package version mismatch, expected 1.0.0-alpha.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
                         );
                     }
                     return binding;
@@ -430,12 +430,12 @@ function requireNative() {
                     const binding = require("@visulima/task-runner-binding-linux-arm-musleabihf");
                     const bindingPackageVersion = require("@visulima/task-runner-binding-linux-arm-musleabihf/package.json").version;
                     if (
-                        bindingPackageVersion !== "1.0.0-alpha.3" &&
+                        bindingPackageVersion !== "1.0.0-alpha.5" &&
                         process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
                         process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== "0"
                     ) {
                         throw new Error(
-                            `Native binding package version mismatch, expected 1.0.0-alpha.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+                            `Native binding package version mismatch, expected 1.0.0-alpha.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
                         );
                     }
                     return binding;
@@ -452,12 +452,12 @@ function requireNative() {
                     const binding = require("@visulima/task-runner-binding-linux-arm-gnueabihf");
                     const bindingPackageVersion = require("@visulima/task-runner-binding-linux-arm-gnueabihf/package.json").version;
                     if (
-                        bindingPackageVersion !== "1.0.0-alpha.3" &&
+                        bindingPackageVersion !== "1.0.0-alpha.5" &&
                         process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
                         process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== "0"
                     ) {
                         throw new Error(
-                            `Native binding package version mismatch, expected 1.0.0-alpha.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+                            `Native binding package version mismatch, expected 1.0.0-alpha.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
                         );
                     }
                     return binding;
@@ -476,12 +476,12 @@ function requireNative() {
                     const binding = require("@visulima/task-runner-binding-linux-loong64-musl");
                     const bindingPackageVersion = require("@visulima/task-runner-binding-linux-loong64-musl/package.json").version;
                     if (
-                        bindingPackageVersion !== "1.0.0-alpha.3" &&
+                        bindingPackageVersion !== "1.0.0-alpha.5" &&
                         process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
                         process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== "0"
                     ) {
                         throw new Error(
-                            `Native binding package version mismatch, expected 1.0.0-alpha.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+                            `Native binding package version mismatch, expected 1.0.0-alpha.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
                         );
                     }
                     return binding;
@@ -498,12 +498,12 @@ function requireNative() {
                     const binding = require("@visulima/task-runner-binding-linux-loong64-gnu");
                     const bindingPackageVersion = require("@visulima/task-runner-binding-linux-loong64-gnu/package.json").version;
                     if (
-                        bindingPackageVersion !== "1.0.0-alpha.3" &&
+                        bindingPackageVersion !== "1.0.0-alpha.5" &&
                         process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
                         process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== "0"
                     ) {
                         throw new Error(
-                            `Native binding package version mismatch, expected 1.0.0-alpha.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+                            `Native binding package version mismatch, expected 1.0.0-alpha.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
                         );
                     }
                     return binding;
@@ -522,12 +522,12 @@ function requireNative() {
                     const binding = require("@visulima/task-runner-binding-linux-riscv64-musl");
                     const bindingPackageVersion = require("@visulima/task-runner-binding-linux-riscv64-musl/package.json").version;
                     if (
-                        bindingPackageVersion !== "1.0.0-alpha.3" &&
+                        bindingPackageVersion !== "1.0.0-alpha.5" &&
                         process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
                         process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== "0"
                     ) {
                         throw new Error(
-                            `Native binding package version mismatch, expected 1.0.0-alpha.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+                            `Native binding package version mismatch, expected 1.0.0-alpha.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
                         );
                     }
                     return binding;
@@ -544,12 +544,12 @@ function requireNative() {
                     const binding = require("@visulima/task-runner-binding-linux-riscv64-gnu");
                     const bindingPackageVersion = require("@visulima/task-runner-binding-linux-riscv64-gnu/package.json").version;
                     if (
-                        bindingPackageVersion !== "1.0.0-alpha.3" &&
+                        bindingPackageVersion !== "1.0.0-alpha.5" &&
                         process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
                         process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== "0"
                     ) {
                         throw new Error(
-                            `Native binding package version mismatch, expected 1.0.0-alpha.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+                            `Native binding package version mismatch, expected 1.0.0-alpha.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
                         );
                     }
                     return binding;
@@ -567,12 +567,12 @@ function requireNative() {
                 const binding = require("@visulima/task-runner-binding-linux-ppc64-gnu");
                 const bindingPackageVersion = require("@visulima/task-runner-binding-linux-ppc64-gnu/package.json").version;
                 if (
-                    bindingPackageVersion !== "1.0.0-alpha.3" &&
+                    bindingPackageVersion !== "1.0.0-alpha.5" &&
                     process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
                     process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== "0"
                 ) {
                     throw new Error(
-                        `Native binding package version mismatch, expected 1.0.0-alpha.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+                        `Native binding package version mismatch, expected 1.0.0-alpha.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
                     );
                 }
                 return binding;
@@ -589,12 +589,12 @@ function requireNative() {
                 const binding = require("@visulima/task-runner-binding-linux-s390x-gnu");
                 const bindingPackageVersion = require("@visulima/task-runner-binding-linux-s390x-gnu/package.json").version;
                 if (
-                    bindingPackageVersion !== "1.0.0-alpha.3" &&
+                    bindingPackageVersion !== "1.0.0-alpha.5" &&
                     process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
                     process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== "0"
                 ) {
                     throw new Error(
-                        `Native binding package version mismatch, expected 1.0.0-alpha.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+                        `Native binding package version mismatch, expected 1.0.0-alpha.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
                     );
                 }
                 return binding;
@@ -615,12 +615,12 @@ function requireNative() {
                 const binding = require("@visulima/task-runner-binding-openharmony-arm64");
                 const bindingPackageVersion = require("@visulima/task-runner-binding-openharmony-arm64/package.json").version;
                 if (
-                    bindingPackageVersion !== "1.0.0-alpha.3" &&
+                    bindingPackageVersion !== "1.0.0-alpha.5" &&
                     process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
                     process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== "0"
                 ) {
                     throw new Error(
-                        `Native binding package version mismatch, expected 1.0.0-alpha.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+                        `Native binding package version mismatch, expected 1.0.0-alpha.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
                     );
                 }
                 return binding;
@@ -637,12 +637,12 @@ function requireNative() {
                 const binding = require("@visulima/task-runner-binding-openharmony-x64");
                 const bindingPackageVersion = require("@visulima/task-runner-binding-openharmony-x64/package.json").version;
                 if (
-                    bindingPackageVersion !== "1.0.0-alpha.3" &&
+                    bindingPackageVersion !== "1.0.0-alpha.5" &&
                     process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
                     process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== "0"
                 ) {
                     throw new Error(
-                        `Native binding package version mismatch, expected 1.0.0-alpha.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+                        `Native binding package version mismatch, expected 1.0.0-alpha.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
                     );
                 }
                 return binding;
@@ -659,12 +659,12 @@ function requireNative() {
                 const binding = require("@visulima/task-runner-binding-openharmony-arm");
                 const bindingPackageVersion = require("@visulima/task-runner-binding-openharmony-arm/package.json").version;
                 if (
-                    bindingPackageVersion !== "1.0.0-alpha.3" &&
+                    bindingPackageVersion !== "1.0.0-alpha.5" &&
                     process.env.NAPI_RS_ENFORCE_VERSION_CHECK &&
                     process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== "0"
                 ) {
                     throw new Error(
-                        `Native binding package version mismatch, expected 1.0.0-alpha.3 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
+                        `Native binding package version mismatch, expected 1.0.0-alpha.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`,
                     );
                 }
                 return binding;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@visulima/task-runner",
-  "version": "1.0.0-alpha.5",
+  "version": "1.0.0-alpha.7",
   "description": "A task runner with caching support for monorepo workspaces",
   "keywords": [
     "visulima",
@@ -52,22 +52,22 @@
     "LICENSE.md"
   ],
   "dependencies": {
-    "@visulima/humanizer": "3.0.0-alpha.10",
-    "@visulima/path": "3.0.0-alpha.9",
-    "@lydell/node-pty": "1.2.0-beta.12"
+    "@lydell/node-pty": "1.2.0-beta.12",
+    "@visulima/humanizer": "3.0.0-alpha.11",
+    "@visulima/path": "3.0.0-alpha.10"
   },
   "optionalDependencies": {
-    "@visulima/task-runner-binding-darwin-arm64": "1.0.0-alpha.5",
-    "@visulima/task-runner-binding-linux-arm64-gnu": "1.0.0-alpha.5",
-    "@visulima/task-runner-binding-darwin-x64": "1.0.0-alpha.5",
-    "@visulima/task-runner-binding-linux-x64-gnu": "1.0.0-alpha.5",
-    "@visulima/task-runner-binding-linux-arm64-musl": "1.0.0-alpha.5",
-    "@visulima/task-runner-binding-linux-x64-musl": "1.0.0-alpha.5",
-    "@visulima/task-runner-binding-win32-arm64-msvc": "1.0.0-alpha.5",
-    "@visulima/task-runner-binding-win32-x64-msvc": "1.0.0-alpha.5"
+    "@visulima/task-runner-binding-darwin-x64": "1.0.0-alpha.7",
+    "@visulima/task-runner-binding-darwin-arm64": "1.0.0-alpha.7",
+    "@visulima/task-runner-binding-linux-x64-gnu": "1.0.0-alpha.7",
+    "@visulima/task-runner-binding-linux-arm64-musl": "1.0.0-alpha.7",
+    "@visulima/task-runner-binding-linux-arm64-gnu": "1.0.0-alpha.7",
+    "@visulima/task-runner-binding-linux-x64-musl": "1.0.0-alpha.7",
+    "@visulima/task-runner-binding-win32-arm64-msvc": "1.0.0-alpha.7",
+    "@visulima/task-runner-binding-win32-x64-msvc": "1.0.0-alpha.7"
   },
   "engines": {
-    "node": ">=22.13 <=25.x"
+    "node": "^22.14.0 || >=24.10.0"
   },
   "publishConfig": {
     "access": "public",