@visulima/task-runner 1.0.0-alpha.17 → 1.0.0-alpha.19

package/CHANGELOG.md

@@ -1,3 +1,39 @@
+## @visulima/task-runner [1.0.0-alpha.19](https://github.com/visulima/visulima/compare/@visulima/task-runner@1.0.0-alpha.18...@visulima/task-runner@1.0.0-alpha.19) (2026-06-04)
+
+### Bug Fixes
+
+* **task-runner:** 3 bug fixes ([ccf08a1](https://github.com/visulima/visulima/commit/ccf08a1faed664d4545b7594bba9afade782b2e5))
+
+
+### Dependencies
+
+* **@visulima/humanizer:** upgraded to 3.0.0-alpha.13
+* **@visulima/path:** upgraded to 3.0.0-alpha.12
+
+## @visulima/task-runner [1.0.0-alpha.18](https://github.com/visulima/visulima/compare/@visulima/task-runner@1.0.0-alpha.17...@visulima/task-runner@1.0.0-alpha.18) (2026-06-02)
+
+### Features
+
+* **task-runner,vis:** per-task pty + concurrency weight, abort cache gate, fspy scaffolds ([#656](https://github.com/visulima/visulima/issues/656)) ([ca64010](https://github.com/visulima/visulima/commit/ca64010b236903e08273680ea65dec7046fcd18b))
+
+### Bug Fixes
+
+* **task-runner:** atomic restoreOutputs and graceful REAPI shutdown ([a3f7088](https://github.com/visulima/visulima/commit/a3f7088c58560f9c98d9d68914ebaf0a458e319d)), closes [#inflightRpcs](https://github.com/visulima/visulima/issues/inflightRpcs) [#closeQuiescenceTimeoutMs](https://github.com/visulima/visulima/issues/closeQuiescenceTimeoutMs)
+* **task-runner:** bound fspy drains so a lingering child can't hang the run ([#666](https://github.com/visulima/visulima/issues/666)) ([3f56348](https://github.com/visulima/visulima/commit/3f56348e1998b50e3b8496ce5f97a9a34932946d)), closes [vite-task#396](https://github.com/visulima/vite-task/issues/396) [vite-task#396](https://github.com/visulima/vite-task/issues/396) [vite-task#396](https://github.com/visulima/vite-task/issues/396) [vite-task#396](https://github.com/visulima/vite-task/issues/396) [vite-task#396](https://github.com/visulima/vite-task/issues/396)
+* **task-runner:** close remaining audit findings ([28c5870](https://github.com/visulima/visulima/commit/28c587008a7f4be73c0e4695f443eccf1a9ed264)), closes [vite-task#358](https://github.com/visulima/vite-task/issues/358)
+* **task-runner:** harden native runner and respect caller FORCE_COLOR ([d1e7231](https://github.com/visulima/visulima/commit/d1e72317428501c1221ffb3c1a4a0e0c5bcfafc0))
+* **task-runner:** harden scheduler, cache, and remote backends ([ce94b16](https://github.com/visulima/visulima/commit/ce94b16c7600967e2d47b1e18975a904f8aef779))
+* **task-runner:** tolerate dev-only dependency cycles ([#664](https://github.com/visulima/visulima/issues/664)) ([9ad384e](https://github.com/visulima/visulima/commit/9ad384e34927b40823ae104d6b05a581dcd05705)), closes [#411](https://github.com/visulima/visulima/issues/411)
+
+### Miscellaneous Chores
+
+* cs fixes ([#659](https://github.com/visulima/visulima/issues/659)) ([61f8912](https://github.com/visulima/visulima/commit/61f891274c1de22a36af256fc981b585b9ec6a6a))
+* **task-runner:** track fspy_macos Cargo.lock ([7a69ff9](https://github.com/visulima/visulima/commit/7a69ff9bcbc25b2c6d8f249c66b135d1ff9a1577))
+
+### Tests
+
+* **task-runner:** regression guard for vite-task[#411](https://github.com/visulima/visulima/issues/411) (peer-dep cycle) ([#665](https://github.com/visulima/visulima/issues/665)) ([41ed071](https://github.com/visulima/visulima/commit/41ed0710d103647137f0448d999f355451f80df4))
+
 ## @visulima/task-runner [1.0.0-alpha.17](https://github.com/visulima/visulima/compare/@visulima/task-runner@1.0.0-alpha.16...@visulima/task-runner@1.0.0-alpha.17) (2026-05-29)
 
 ### Bug Fixes

package/README.md

@@ -34,6 +34,7 @@
 - **npm script-shell support**: Honors `npm config set script-shell` for custom shells (Git Bash, etc.)
 - **Long-running process support**: Configurable stdin mode (null/pipe/inherit), bounded output buffers
 - **Two caching modes**: Nx-style explicit inputs or Vite Task-style auto-fingerprinting
+- **3-tier auto-fingerprint dispatch on Linux**: kernel-level `seccomp_unotify` (catches Alpine/musl/static-binary children), `strace` fallback, then no-op. The seccomp path uses a tiny `fspy-seccomp-helper` binary bundled with the platform binding package — sidesteps the fork-from-multithreaded hazard of installing seccomp in `pre_exec` from Node's NAPI host. See `rfc/design-fspy-seccomp-unotify.md`.
 - **Smart lockfile hashing**: Only hashes resolved versions relevant to each package (like Turborepo)
 - **Framework env inference**: Auto-detects Next.js, Vite, CRA, Gatsby, Nuxt, and more
 - **Remote caching**: Turborepo-compatible HTTP cache protocol, plus a Bazel REAPI gRPC backend (bazel-remote, BuildBuddy, BuildBarn, EngFlow)
@@ -49,6 +50,7 @@
 - **Output archiving**: Caches and restores build outputs (dist/ directories)
 - **LRU cache eviction**: Configurable max size and age limits
 - **Lifecycle hooks**: 7 hook points for custom behavior
+- **Cooperative cache hints**: tools can refine the inferred fingerprint from the inside via the zero-dependency [`@visulima/task-runner-client`](../task-runner-client) — `ignoreInput`/`ignoreOutput` to drop noise, `disableCache` for non-deterministic runs, and `getEnv`/`getEnvs` to register env-var dependencies at the point of use (closing the silent under-tracking gap that pattern-only env config leaves open). Complements observation: works on every platform, no client = no change.
 
 ## Install
 

package/dist/index.d.ts

@@ -39,15 +39,70 @@ declare class FileAccessTracker {
   */
   isSupported(): boolean;
   /**
+  * True when the macOS DYLD-interpose tracker is usable. Unlike
+  * {@link isSupported} (which gates the syscall-level Linux paths),
+  * interpose only covers *directly-exec'd* commands — the caller
+  * must additionally check {@link parseDirectExec} and fall back to
+  * the preload path for shell-syntax commands.
+  */
+  isInterposeSupported(): boolean;
+  /**
+  * Tracks a directly-exec'd `argv` via the macOS interpose dylib.
+  * `argv` MUST come from {@link parseDirectExec} (a single binary,
+  * no shell syntax) — it is exec'd directly, never through a shell,
+  * so `DYLD_INSERT_LIBRARIES` survives SIP. Degrades to the
+  * no-tracking path if the addon/dylib went missing since the
+  * availability check.
+  */
+  trackInterpose(argv: string[], options?: {
+    abortSignal?: AbortSignal;
+    cwd?: string;
+    env?: Record<string, string | undefined>;
+  }): Promise<TrackingResult>;
+  /**
+  * True when the Windows IAT-hook tracker is usable. Like
+  * {@link isInterposeSupported}, only covers *directly-exec'd*
+  * commands (the DLL is injected into the spawned binary, with no
+  * child-process propagation) — the caller must gate on
+  * {@link parseDirectExec} and fall back to the preload path for
+  * shell-syntax commands.
+  */
+  isIatHookSupported(): boolean;
+  /**
+  * Tracks a directly-exec'd `argv` via the Windows `fspy_windows`
+  * DLL (IAT hooks). `argv` MUST come from {@link parseDirectExec}.
+  * Degrades to the no-tracking path if the addon/DLL went missing
+  * since the availability check.
+  */
+  trackIatHook(argv: string[], options?: {
+    abortSignal?: AbortSignal;
+    cwd?: string;
+    env?: Record<string, string | undefined>;
+  }): Promise<TrackingResult>;
+  /**
   * Runs a command and tracks all file system accesses.
-  * On unsupported platforms, runs the command without tracking.
+  *
+  * Dispatch order (highest fidelity first):
+  * 1. **seccomp_unotify** — kernel-level interception via the
+  *    bundled helper binary. Catches static binaries and musl
+  *    children that the strace + preload paths miss. Linux only.
+  * 2. **strace** — userspace fallback when seccomp isn't
+  *    available (no native addon, no helper bin, kernel < 5.0).
+  * 3. **no-op** — on every other platform, run the command and
+  *    return zero accesses so the orchestrator's empty-fingerprint
+  *    diagnostic fires.
   */
   track(command: string, options?: {
+    /** When fired, SIGTERMs the active spawn for this call. */
+    abortSignal?: AbortSignal;
     cwd?: string;
     env?: Record<string, string | undefined>;
   }): Promise<TrackingResult>;
   /**
-  * Kills all active child processes. Called on abort/signal to prevent orphans.
+  * Kills all active child processes. Called on abort/signal to
+  * prevent orphans. Works for both `ChildProcess` (strace path)
+  * and the seccomp helper PID stub via the shared `Killable`
+  * shape.
   */
   killAll(): void;
 }
@@ -631,6 +686,14 @@ interface Task {
   * {@link TaskRunnerOptions.concurrencyGroups}.
   */
   concurrencyGroup?: string;
+  /**
+  * Per-task slot weight against the global `parallel` cap. Defaults
+  * to `1` (one slot). Carried over from
+  * {@link TargetConfiguration.concurrencyWeight}; values `&lt;= 0`,
+  * non-finite, or non-integer are ignored (treated as `1` — matches
+  * `resolveWeight` in `task-scheduler.ts`).
+  */
+  concurrencyWeight?: number;
   /** Hash of the task inputs for caching */
   hash?: string;
   /** Detailed hash information */
@@ -670,6 +733,15 @@ interface Task {
   priority?: TaskPriority;
   /** The project root directory */
   projectRoot?: string;
+  /**
+  * Per-task PTY override. When `true`, this task spawns inside a
+  * pseudo-terminal even if the workspace-level toggle is off (or
+  * vice versa when `false`). Carried over from
+  * {@link TargetConfiguration.pty}. Consumed by the runner that
+  * actually spawns the command — the task-runner library exposes
+  * the flag and leaves the spawn decision to the executor.
+  */
+  pty?: boolean;
   /** The target this task executes */
   target: TaskTarget;
   /**
@@ -722,6 +794,33 @@ type TaskStatus = "success" | "failure" | "skipped" | "local-cache" | "local-cac
 * Result of executing a task.
 */
 interface TaskResult {
+  /**
+  * Set when the task asked the runner not to cache this run by calling
+  * `disableCache()` from `@visulima/task-runner-client`. Unlike
+  * {@link TaskResult.emptyFingerprint}, the fingerprint may be perfectly
+  * valid — the task itself declared the run non-deterministic (network
+  * flake, debug mode, aborted watch). Surfaced to reporters and the run
+  * summary so the skip is explained rather than silent.
+  */
+  cacheDisabledByTask?: boolean;
+  /**
+  * Provenance of the cooperative cache hints a task emitted via
+  * `@visulima/task-runner-client` during this run. Present only when
+  * the task registered at least one hint, so the common (no-client)
+  * path leaves it `undefined`. Surfaced in `--summarize` output so a
+  * cache key can be explained: which reads/writes were ignored and
+  * which env vars/patterns were registered as dependencies.
+  */
+  cacheHints?: {
+    /** Absolute paths whose reads were dropped from inferred inputs. */
+    ignoredInputs: string[];
+    /** Absolute paths whose writes were dropped from inferred outputs. */
+    ignoredOutputs: string[];
+    /** Env var names registered as cache dependencies via `getEnv`. */
+    trackedEnv: string[];
+    /** Env glob patterns registered as cache dependencies via `getEnvs`. */
+    trackedEnvPatterns: string[];
+  };
   /** The exit code, if applicable */
   code?: number;
   /**
@@ -866,6 +965,20 @@ interface TargetConfiguration {
   * finalisation phase outside the scheduler.
   */
   concurrencyGroup?: string;
+  /**
+  * Per-task slot weight against the global `parallel` cap. Defaults
+  * to `1`. A task with `concurrencyWeight: 2` consumes two slots; with
+  * `parallel: 4` only two such tasks can run concurrently (or one
+  * weight-2 plus two weight-1). Use for CPU-pinning tasks — bundlers,
+  * `tsc`, native compiles — where the runner shouldn't keep
+  * over-subscribing the box just because slots are nominally free.
+  *
+  * The scheduler always lets a single task run even if its weight
+  * exceeds the remaining budget; otherwise a heavy task on a
+  * `parallel: 1` pool would deadlock. Values `&lt;= 0`, non-finite, or
+  * non-integer are ignored (treated as `1`).
+  */
+  concurrencyWeight?: number;
   /** Named configurations (e.g., "production", "development") */
   configurations?: Record<string, Record<string, unknown>>;
   /** Other targets this target depends on */
@@ -935,6 +1048,19 @@ interface TargetConfiguration {
   /** Whether this target supports parallel execution */
   parallelism?: boolean;
   /**
+  * Per-target PTY override. When `true`, every task spawned from
+  * this target runs inside a pseudo-terminal (so `isatty()` returns
+  * true and the child preserves color / progress UI). When `false`,
+  * the workspace-level PTY toggle is suppressed for this target.
+  * Useful when most targets are happy with piped stdio but one
+  * tool (vitest, prettier, a colorising linter) needs a real TTY,
+  * or vice versa.
+  *
+  * Absent means "follow the workspace default" — the executor
+  * decides based on its own toggles.
+  */
+  pty?: boolean;
+  /**
   * Regex source string(s) that mark a successful task as having
   * emitted warnings. The orchestrator scans the task's combined
   * terminal output after a 0-exit and, on first match, sets
@@ -1188,6 +1314,18 @@ interface TaskRunnerOptions {
   */
   autoFingerprint?: boolean;
   /**
+  * Failure-propagation policy.
+  *
+  * - `false` (default) — when a task fails, its transitive
+  *   dependents are marked `skipped`. Tasks not downstream of the
+  *   failure still run. Prevents cascade failures from running a
+  *   dependent on a missing `dist/` produced by the failed dep.
+  * - `true` — fail-fast. On the first failure every not-yet-started
+  *   task is marked `skipped`; in-flight tasks finish naturally.
+  * @default false
+  */
+  bail?: boolean;
+  /**
   * Whether to show cache miss diagnostics (why a cache miss occurred).
   * @default false
   */
@@ -1588,6 +1726,13 @@ interface LifeCycleInterface {
   * semantics — same contract, different stream.
   */
   onTaskStdout?: (task: Task, chunk: string) => void;
+  /**
+  * Called when caching is skipped because the task itself requested it
+  * via `disableCache()` (`@visulima/task-runner-client`). Distinct from
+  * {@link LifeCycleInterface.printEmptyFingerprintWarning}: the
+  * fingerprint may be valid; the task declared the run non-cacheable.
+  */
+  printCacheDisabledByTask?: (task: Task) => void;
   /** Called when a cache miss occurs with diagnostic information */
   printCacheMiss?: (task: Task, reasons: string) => void;
   /**
@@ -2045,6 +2190,14 @@ declare class Cache {
   /**
   * Removes old cache entries that exceed the maximum age,
   * and enforces the maximum cache size by evicting oldest entries.
+  *
+  * NOTE: `maxCacheSize` only bounds the *legacy* `<hash>/` entry
+  * layout. The v2 CAS subtree (rooted at {@link V2_ROOT}) is skipped
+  * here — it manages its own lifetime via blob-level touch + reference
+  * accounting (see `cas/store.ts`) and is deliberately excluded from
+  * both age and size accounting below. Consequently a cache dominated
+  * by v2 blobs reports a small measured size and may exceed
+  * `maxCacheSize`; size-based eviction is not driven from the CAS GC.
   */
   removeOldEntries(): Promise<void>;
   /**
@@ -2143,6 +2296,20 @@ declare const touchBlob: (root: string, digest: CasDigest) => Promise<void>;
 interface TaskSummary {
   /** Whether the task was cacheable */
   cacheable: boolean;
+  /**
+  * Provenance of cooperative cache hints the task emitted via
+  * `@visulima/task-runner-client` ({@link TaskResult.cacheHints}).
+  * Omitted when the task used no client hints.
+  */
+  cacheHints?: TaskResult["cacheHints"];
+  /**
+  * Why a cacheable task that ran (exit 0) seeded no cache entry.
+  * Omitted for cache hits, failures, and ordinary cache writes.
+  * `disabled-by-task` — the task called `disableCache()`;
+  * `self-modified` — it rewrote one of its own tracked inputs;
+  * `empty-fingerprint` — tracking observed no workspace accesses.
+  */
+  cacheSkipReason?: "disabled-by-task" | "empty-fingerprint" | "self-modified";
   /** Cache status */
   cacheStatus: "HIT" | "MISS" | "REMOTE_HIT" | "SKIPPED";
   /** Dependencies on other tasks */
@@ -2760,6 +2927,9 @@ declare class CompositeLifeCycle implements LifeCycleInterface {
   endTasks(taskResults: TaskResult[]): void;
   printTaskTerminalOutput(task: Task, status: TaskStatus, terminalOutput: string): void;
   printCacheMiss(task: Task, reasons: string): void;
+  printCacheDisabledByTask(task: Task): void;
+  printEmptyFingerprintWarning(task: Task, reason: string): void;
+  printSelfModifyingSkip(task: Task, modifiedFiles: string[]): void;
   onTaskStdout(task: Task, chunk: string): void;
   onTaskStderr(task: Task, chunk: string): void;
 }
@@ -2866,6 +3036,23 @@ declare class LockfileHasher {
 */
 type LogMode = "grouped" | "interleaved" | "labeled";
 /**
+* How the reporter handles ANSI escape sequences in the buffered output
+* it receives.
+*
+* - `auto` **(default)**: detect color capability of the write target;
+*   strip escapes when stdout isn't a TTY, `NO_COLOR` is set, or
+*   `TERM=dumb`. Matches what colorize libraries do for live output.
+* - `always`: keep escapes — useful when piping into another tool that
+*   understands ANSI.
+* - `never`: always strip — useful for log files / JSON-collecting CI.
+*
+* Live spawn output is captured with `FORCE_COLOR=1` so cache entries
+* always contain colored bytes; without this control, replaying a cache
+* hit into a non-color destination prints raw escape sequences. See
+* voidzero-dev/vite-task#358 / #378.
+*/
+type ColorMode = "always" | "auto" | "never";
+/**
 * A lifecycle handler that renders task terminal output per {@link LogMode}.
 *
 * Operates on the buffered `printTaskTerminalOutput` signal the orchestrator
@@ -2875,7 +3062,7 @@ type LogMode = "grouped" | "interleaved" | "labeled";
 */
 declare class LogReporter implements LifeCycleInterface {
   #private;
-  constructor(mode: LogMode, write?: (chunk: string) => void);
+  constructor(mode: LogMode, write?: (chunk: string) => void, color?: ColorMode);
   printTaskTerminalOutput(task: Task, _status: TaskStatus, terminalOutput: string): void;
   endTasks(_taskResults: TaskResult[]): void;
 }
@@ -2884,7 +3071,7 @@ declare class LogReporter implements LifeCycleInterface {
 * Consumers that already compose their own lifecycle handlers can instantiate
 * {@link LogReporter} directly.
 */
-declare const createLogReporter: (mode: LogMode, write?: (chunk: string) => void) => LogReporter;
+declare const createLogReporter: (mode: LogMode, write?: (chunk: string) => void, color?: ColorMode) => LogReporter;
 interface NativeFileHash {
   hash: string;
   path: string;
@@ -2963,6 +3150,51 @@ interface NativeBindings {
   runConcurrent: (commands: NativeConcurrentCommandConfig[], options: NativeConcurrentRunnerOptions, onEvent: (event: NativeProcessEvent) => void) => Promise<NativeConcurrentRunResult>;
   runConcurrentBatch: (commands: NativeConcurrentCommandConfig[], options: NativeConcurrentRunnerOptions, onLifecycle?: ((event: NativeProcessEvent) => void) | null) => Promise<NativeConcurrentRunResult>;
   topologicalSort: (graph: NativeTaskGraph) => string[];
+  /**
+  * Windows-only: spawn the directly-exec'd `argv` suspended, inject
+  * the `fspy_windows` DLL (at `dllPath`) via
+  * `CreateRemoteThread(LoadLibraryW)`, and collect the IAT-hooked
+  * accesses streamed over a named pipe. Same result shape as
+  * `trackWithSeccomp`. Present only when the addon was built for a
+  * Windows target.
+  */
+  trackWithIatHook?: (argv: string[], dllPath: string, options?: NativeSeccompSpawnOptions, onStarted?: (pid: number) => void) => Promise<NativeSeccompTrackingResult>;
+  /**
+  * macOS-only: spawn the directly-exec'd `argv` with the
+  * `fspy_macos` interpose dylib (at `dylibPath`) injected via
+  * `DYLD_INSERT_LIBRARIES` and collect reported accesses. Same
+  * result shape as `trackWithSeccomp`. Present only when the
+  * addon was built for a macOS target.
+  */
+  trackWithInterpose?: (argv: string[], dylibPath: string, options?: NativeSeccompSpawnOptions, onStarted?: (pid: number) => void) => Promise<NativeSeccompTrackingResult>;
+  /**
+  * Linux-only: spawn `argv` under seccomp_unotify tracking via
+  * the helper binary at `helperPath`. Resolves once the child
+  * exits with the gathered file accesses.
+  *
+  * `onStarted` (when supplied) fires once with the helper PID
+  * as soon as the spawn succeeds. The PID survives the
+  * helper→target execve, so callers can SIGTERM it via
+  * `process.kill(pid)` to abort the traced command.
+  *
+  * Undefined when the addon was built on a non-Linux target.
+  */
+  trackWithSeccomp?: (argv: string[], helperPath: string, options?: NativeSeccompSpawnOptions, onStarted?: (pid: number) => void) => Promise<NativeSeccompTrackingResult>;
+}
+interface NativeSeccompSpawnOptions {
+  cwd?: string;
+  /** Extra env vars merged on top of the parent's. */
+  env?: Record<string, string>;
+}
+interface NativeSeccompFileAccess {
+  kind: "missing" | "read" | "readdir" | "stat" | "write";
+  path: string;
+}
+interface NativeSeccompTrackingResult {
+  accesses: NativeSeccompFileAccess[];
+  exitCode: number;
+  stderr: Buffer;
+  stdout: Buffer;
 }
 /**
 * Attempts to load the native addon. Returns undefined if unavailable.
@@ -3044,7 +3276,7 @@ declare const parseInputUri: (input: string) => InputDefinition | undefined;
 declare const looksLikeInputUri: (input: string) => boolean;
 /**
 * Walks from `cwd` (resolved against `process.cwd()` when relative)
-* up to the filesystem root, returning every `<dir>/node_modules/.bin`
+* up to the filesystem root, returning every `&lt;dir>/node_modules/.bin`
 * path encountered. Ordered nearest-first so the cwd-local `.bin`
 * shadows ancestor `.bin` directories, matching npm/pnpm semantics.
 *
@@ -3080,6 +3312,15 @@ declare const withEnhancedPath: <T extends NodeJS.ProcessEnv | Record<string, st
 */
 declare const enforceProjectConstraints: (projectGraph: ProjectGraph, constraints: ConstraintsConfig) => ConstraintViolation[];
 interface CreateTaskGraphOptions {
+  /**
+  * Invoked once per dependency cycle that {@link createTaskGraph}
+  * breaks because it runs *solely* through soft (devDependency)
+  * edges. The argument is the cycle as a closed path of task ids
+  * (`[a, b, …, a]`). Consumers can surface this as a warning; cycles
+  * that contain a hard (static) edge are left intact and never
+  * reported here.
+  */
+  onCycleBroken?: (cycle: string[]) => void;
   /** The project graph */
   projectGraph: ProjectGraph;
   /** Target default configurations */
@@ -3275,6 +3516,12 @@ declare class TaskScheduler {
   constructor(taskGraph: TaskGraph, projectGraph: ProjectGraph, maxParallel?: number, concurrencyGroups?: ConcurrencyGroups);
   /**
   * Returns the next batch of tasks that are ready to execute.
+  *
+  * Slot accounting is weighted: a task's `concurrencyWeight` (default
+  * `1`) counts against the global `parallel` cap. A heavier task may
+  * still run alone — when nothing is in flight, the scheduler always
+  * admits at least one ready task even if its weight exceeds the cap,
+  * so a `parallel: 1` pool can't deadlock on a weight-3 task.
   */
   getNextBatch(): Task[];
   startTask(taskId: string): void;
@@ -3282,6 +3529,26 @@ declare class TaskScheduler {
   isComplete(): boolean;
   get remainingCount(): number;
   get runningCount(): number;
+  /**
+  * Returns dep-id refs the task graph carries that don't resolve to
+  * any task in `tasks`, keyed by the task that declared them. The
+  * scheduler treats these as already-completed so the run can
+  * proceed, but the orchestrator surfaces this map as a warning at
+  * run start so the underlying input bug (vis / config emitting
+  * dangling refs) doesn't go silently masked.
+  */
+  getOrphanDependencies(): Map<string, string[]>;
+  /**
+  * Returns task ids that are not in `completedTasks` and not in
+  * `runningTasks`, along with their unmet deps after orphan refs
+  * have been filtered out. The orchestrator's deadlock error reads
+  * this so the message can name the actual stranded tasks instead
+  * of a generic "may indicate a circular dependency" hint.
+  */
+  describeStrandedTasks(): {
+    id: string;
+    unmetDeps: string[];
+  }[];
 }
 /**
 * Options for the TaskOrchestrator.
@@ -3296,6 +3563,19 @@ interface TaskOrchestratorOptions {
   */
   alwaysTasks?: Task[];
   autoFingerprint?: boolean;
+  /**
+  * Failure-propagation policy.
+  *
+  * - `false` (default) — when a task fails, its transitive
+  *   dependents are marked `skipped` with a "dependency failed"
+  *   note. Tasks not downstream of the failure still run. Prevents
+  *   the cascade failures that result from running a dependent on
+  *   a missing `dist/` produced by the failed dep.
+  * - `true` — fail-fast. On the first failure every task that
+  *   hasn't started is marked `skipped`; in-flight tasks are
+  *   allowed to finish.
+  */
+  bail?: boolean;
   cache: Cache;
   cacheDiagnostics?: boolean;
   captureOutput?: boolean;
@@ -3372,6 +3652,23 @@ declare class TerminalBuffer {
   toString(): string;
 }
 /**
+* Hints aggregated from a task's NDJSON file, with paths resolved to
+* absolute form against the child's cwd. Consumed by the orchestrator
+* to refine the auto-fingerprint before it's sealed.
+*/
+interface CollectedHints {
+  /** The task asked not to cache this run (via `disableCache()`). */
+  cacheDisabled: boolean;
+  /** Absolute paths whose reads should be dropped from inferred inputs. */
+  ignoredInputs: string[];
+  /** Absolute paths whose writes should be dropped from inferred outputs. */
+  ignoredOutputs: string[];
+  /** Env var names registered as cache dependencies via `getEnv`. */
+  trackedEnv: string[];
+  /** Env glob patterns registered as cache dependencies via `getEnvs`. */
+  trackedEnvPatterns: string[];
+}
+/**
 * Result of a tracked task execution.
 */
 interface TrackedExecutionResult {
@@ -3379,6 +3676,12 @@ interface TrackedExecutionResult {
   accesses: FileAccess[];
   /** The command exit code */
   code: number;
+  /**
+  * Cooperative cache hints the task emitted via
+  * `@visulima/task-runner-client` ({@link CollectedHints}). Empty when
+  * the task didn't use the client.
+  */
+  hints: CollectedHints;
   /** The command stdout + stderr output */
   terminalOutput: string;
 }

package/dist/index.js

@@ -1 +1 @@
-import{buildForwardDependencyMap as o,buildReverseDependencyMap as t,expandAffected as a,filterAffectedTasks as s,getAffectedProjects as p,getChangedFiles as n}from"./packem_shared/buildForwardDependencyMap-w1FVPFdv.js";import{createRemoteCacheBackend as i,resolveCacheMode as c,resolveTurboEnvCompat as f}from"./packem_shared/resolveCacheMode-DEDFC-kM.js";import{actionDigestForTaskHash as x,containsByTaskHash as h,retrieveByTaskHash as d,storeByTaskHash as u}from"./packem_shared/actionDigestForTaskHash-BOL4fZ9v.js";import{HttpRemoteCache as T}from"./packem_shared/HttpRemoteCache-D3Z6b_FO.js";import{ReapiRemoteCache as g}from"./packem_shared/ReapiRemoteCache-B3uQuVqP.js";import{Cache as R,DEFAULT_CACHE_DIRECTORY_NAME as v,formatCacheSize as F,parseCacheSize as B}from"./packem_shared/Cache-C540ZPYk.js";import{digestBuffer as E,digestFile as P}from"./packem_shared/digestBuffer-g11aCaDx.js";import{V2_AC as I,V2_CAS as L,V2_INDEX as H,V2_ROOT as A,V2_TMP as w,acEntryPath as D,casBlobPath as _,taskHashIndexPath as M}from"./packem_shared/V2_ROOT-injxWBrl.js";import{containsBlob as N,fetchBlobToFile as O,putBlobFromBytes as U,putBlobFromFile as V,touchBlob as W,verifyBlob as j}from"./packem_shared/containsBlob-DBWgvkM_.js";import{toChromeTrace as Y,writeChromeTrace as q}from"./packem_shared/toChromeTrace-DxN5NQIU.js";import{parseCommands as K}from"./packem_shared/parseCommands-BHsXoUCd.js";import{runConcurrently as X}from"./packem_shared/runConcurrently-ebFf3uYs.js";import{runConcurrentFallback as $}from"./packem_shared/runConcurrentFallback-SvS4ElEX.js";import{defaultTaskRunner as re}from"./packem_shared/defaultTaskRunner-CjaCnt_W.js";import{detectScriptShell as te}from"./packem_shared/detectScriptShell-CaTDk5cW.js";import{FileAccessTracker as se,generatePreloadScript as pe}from"./packem_shared/FileAccessTracker-IG-Z0Ijw.js";import{FingerprintManager as me}from"./packem_shared/FingerprintManager-CYW2EwLc.js";import{detectFrameworks as ce,getFrameworkEnvVariables as fe,inferFrameworkEnvPatterns as le}from"./packem_shared/detectFrameworks-WVZJOPgN.js";import{projectGraphToDot as he,toGraphAscii as de,toGraphHtml as ue,toGraphJson as ke,toGraphvizDot as Te}from"./packem_shared/projectGraphToDot-FN6oHDGH.js";import{IncrementalFileHasher as ge}from"./packem_shared/IncrementalFileHasher-CdLXVB5F.js";import{CompositeLifeCycle as Re,ConsoleLifeCycle as ve,EmptyLifeCycle as Fe}from"./packem_shared/CompositeLifeCycle-D0zWvAXJ.js";import{LockfileHasher as be,extractPackageName as Ee,parseNpmLockfile as Pe,parsePnpmLockfile as Se,parseYarnLockfile as Ie}from"./packem_shared/extractPackageName-BeL6Gc3a.js";import{LogReporter as He,createLogReporter as Ae}from"./packem_shared/LogReporter-BUPWiXAq.js";import{isNativeAvailable as De,loadNativeBindings as _e}from"./packem_shared/isNativeAvailable-BOavFPX1.js";import{resolveOutputs as Ge}from"./packem_shared/resolveOutputs-BBjdaraf.js";import{INPUT_URI_SCHEMES as Oe,InvalidInputUriError as Ue,looksLikeInputUri as Ve,parseInputUri as We}from"./packem_shared/INPUT_URI_SCHEMES-Csrd0tlg.js";import{buildEnhancedPath as ze,collectNodeModulesBinDirs as Ye,withEnhancedPath as qe}from"./packem_shared/collectNodeModulesBinDirs-JaeFLP9l.js";import{enforceProjectConstraints as Ke}from"./packem_shared/enforceProjectConstraints-dNc1SwRi.js";import{generateRunSummary as Xe,getLastRunSummaryPath as Ze,readLastRunSummary as $e,writeLastRunSummary as er,writeRunSummary as rr}from"./packem_shared/generateRunSummary-beN13GH4.js";import{createTaskGraph as tr,getTaskId as ar,parseTaskId as sr}from"./packem_shared/createTaskGraph-D6nPDd4s.js";import{findCycle as nr,findCycles as mr,getDependentTasks as ir,getLeafTasks as cr,getTransitiveDependencies as fr,makeAcyclic as lr,reverseTaskGraph as xr,walkTaskGraph as hr}from"./packem_shared/findCycle-BY8-jmzB.js";import{InProcessTaskHasher as ur,computeTaskHash as kr}from"./packem_shared/computeTaskHash-Xxd8v-X3.js";import{TaskOrchestrator as Cr}from"./packem_shared/TaskOrchestrator-F_NrcUYn.js";import{TaskScheduler as yr,parsePartition as Rr}from"./packem_shared/parsePartition-uzPNgtPp.js";import{TerminalBuffer as Fr}from"./packem_shared/TerminalBuffer-BtZy7TpT.js";import{TrackedTaskExecutor as br}from"./packem_shared/TrackedTaskExecutor-BiK0Coso.js";import{d as Pr,j as Sr,T as Ir,b as Lr,E as Hr,v as Ar,h as wr,O as Dr}from"./packem_shared/utils-BH2W5Wml.js";import{evaluateWhen as Mr,explainWhen as Gr,getCurrentBranch as Nr,resetBranchCache as Or}from"./packem_shared/getCurrentBranch-D-qoZByx.js";import{getMainWorktreeRoot as Vr,isLinkedWorktree as Wr,resetWorktreeCache as jr}from"./packem_shared/getMainWorktreeRoot-DRN_i8jA.js";import{createInputHandler as Yr}from"./packem_shared/createInputHandler-CkDCpPYy.js";import{expandArguments as Jr}from"./packem_shared/expandArguments-D7qvc6Rp.js";import{expandShortcut as Qr}from"./packem_shared/expandShortcut-BErNHNXZ.js";import{expandTokens as Zr,expandTokensInString as $r}from"./packem_shared/expandTokensInString-DVSFEdWu.js";import{expandWildcard as ro}from"./packem_shared/expandWildcard-DE0dOOZF.js";import{formatTimingTable as to,logTimings as ao}from"./packem_shared/formatTimingTable-CP3rsDwf.js";import{runTeardown as po}from"./packem_shared/runTeardown-CiJJeWVf.js";import{stripQuotes as mo}from"./packem_shared/stripQuotes-jkZb0CL9.js";import{withRestart as co}from"./packem_shared/withRestart-DKtEGsQA.js";export{R as Cache,Re as CompositeLifeCycle,ve as ConsoleLifeCycle,v as DEFAULT_CACHE_DIRECTORY_NAME,Fe as EmptyLifeCycle,se as FileAccessTracker,me as FingerprintManager,T as HttpRemoteCache,Oe as INPUT_URI_SCHEMES,ur as InProcessTaskHasher,ge as IncrementalFileHasher,Ue as InvalidInputUriError,be as LockfileHasher,He as LogReporter,g as ReapiRemoteCache,Cr as TaskOrchestrator,yr as TaskScheduler,Fr as TerminalBuffer,br as TrackedTaskExecutor,I as V2_AC,L as V2_CAS,H as V2_INDEX,A as V2_ROOT,w as V2_TMP,D as acEntryPath,x as actionDigestForTaskHash,ze as buildEnhancedPath,o as buildForwardDependencyMap,t as buildReverseDependencyMap,_ as casBlobPath,Pr as collectFiles,Ye as collectNodeModulesBinDirs,kr as computeTaskHash,N as containsBlob,h as containsByTaskHash,Sr as createFailureResult,Yr as createInputHandler,Ae as createLogReporter,i as createRemoteCacheBackend,tr as createTaskGraph,re as defaultTaskRunner,ce as detectFrameworks,te as detectScriptShell,E as digestBuffer,P as digestFile,Ke as enforceProjectConstraints,Mr as evaluateWhen,a as expandAffected,Jr as expandArguments,Qr as expandShortcut,Zr as expandTokens,$r as expandTokensInString,ro as expandWildcard,Gr as explainWhen,Ee as extractPackageName,O as fetchBlobToFile,s as filterAffectedTasks,nr as findCycle,mr as findCycles,F as formatCacheSize,to as formatTimingTable,pe as generatePreloadScript,Xe as generateRunSummary,p as getAffectedProjects,n as getChangedFiles,Nr as getCurrentBranch,ir as getDependentTasks,fe as getFrameworkEnvVariables,Ze as getLastRunSummaryPath,cr as getLeafTasks,Vr as getMainWorktreeRoot,ar as getTaskId,fr as getTransitiveDependencies,Ir as hashFile,Lr as hashStrings,le as inferFrameworkEnvPatterns,Wr as isLinkedWorktree,De as isNativeAvailable,_e as loadNativeBindings,ao as logTimings,Ve as looksLikeInputUri,lr as makeAcyclic,B as parseCacheSize,K as parseCommands,We as parseInputUri,Pe as parseNpmLockfile,Rr as parsePartition,Se as parsePnpmLockfile,sr as parseTaskId,Ie as parseYarnLockfile,he as projectGraphToDot,U as putBlobFromBytes,V as putBlobFromFile,$e as readLastRunSummary,Hr as readPackageDeps,Or as resetBranchCache,jr as resetWorktreeCache,c as resolveCacheMode,Ge as resolveOutputs,Ar as resolveTaskCwd,f as resolveTurboEnvCompat,d as retrieveByTaskHash,xr as reverseTaskGraph,$ as runConcurrentFallback,X as runConcurrently,po as runTeardown,wr as sortObjectKeys,u as storeByTaskHash,mo as stripQuotes,M as taskHashIndexPath,Y as toChromeTrace,de as toGraphAscii,ue as toGraphHtml,ke as toGraphJson,Te as toGraphvizDot,W as touchBlob,Dr as uniqueId,j as verifyBlob,hr as walkTaskGraph,qe as withEnhancedPath,co as withRestart,q as writeChromeTrace,er as writeLastRunSummary,rr as writeRunSummary};
+import{buildForwardDependencyMap as o,buildReverseDependencyMap as t,expandAffected as a,filterAffectedTasks as s,getAffectedProjects as p,getChangedFiles as n}from"./packem_shared/buildForwardDependencyMap-DudUDFze.js";import{createRemoteCacheBackend as i,resolveCacheMode as c,resolveTurboEnvCompat as f}from"./packem_shared/resolveCacheMode--4y60ODd.js";import{actionDigestForTaskHash as x,containsByTaskHash as h,retrieveByTaskHash as d,storeByTaskHash as u}from"./packem_shared/actionDigestForTaskHash-BOL4fZ9v.js";import{HttpRemoteCache as T}from"./packem_shared/HttpRemoteCache-CpPl6lzE.js";import{ReapiRemoteCache as g}from"./packem_shared/ReapiRemoteCache-BXJip5wH.js";import{Cache as R,DEFAULT_CACHE_DIRECTORY_NAME as v,formatCacheSize as F,parseCacheSize as B}from"./packem_shared/Cache-BVrj9bd4.js";import{digestBuffer as E,digestFile as P}from"./packem_shared/digestBuffer-g11aCaDx.js";import{V2_AC as I,V2_CAS as L,V2_INDEX as H,V2_ROOT as A,V2_TMP as w,acEntryPath as D,casBlobPath as _,taskHashIndexPath as M}from"./packem_shared/V2_ROOT-injxWBrl.js";import{containsBlob as N,fetchBlobToFile as O,putBlobFromBytes as U,putBlobFromFile as V,touchBlob as W,verifyBlob as j}from"./packem_shared/containsBlob-DAU8R7GH.js";import{toChromeTrace as Y,writeChromeTrace as q}from"./packem_shared/toChromeTrace-DxN5NQIU.js";import{parseCommands as K}from"./packem_shared/parseCommands-BHsXoUCd.js";import{runConcurrently as X}from"./packem_shared/runConcurrently-D1Ytsjaj.js";import{runConcurrentFallback as $}from"./packem_shared/runConcurrentFallback-BhJCT2LA.js";import{defaultTaskRunner as re}from"./packem_shared/defaultTaskRunner-RJnuLoJz.js";import{detectScriptShell as te}from"./packem_shared/detectScriptShell-CaTDk5cW.js";import{FileAccessTracker as se,generatePreloadScript as pe}from"./packem_shared/FileAccessTracker-DBz_w4wl.js";import{FingerprintManager as me}from"./packem_shared/FingerprintManager-CYW2EwLc.js";import{detectFrameworks as ce,getFrameworkEnvVariables as fe,inferFrameworkEnvPatterns as le}from"./packem_shared/detectFrameworks-WVZJOPgN.js";import{projectGraphToDot as he,toGraphAscii as de,toGraphHtml as ue,toGraphJson as ke,toGraphvizDot as Te}from"./packem_shared/projectGraphToDot-FN6oHDGH.js";import{IncrementalFileHasher as ge}from"./packem_shared/IncrementalFileHasher-B-V3i2x-.js";import{CompositeLifeCycle as Re,ConsoleLifeCycle as ve,EmptyLifeCycle as Fe}from"./packem_shared/CompositeLifeCycle-C6aee9GK.js";import{LockfileHasher as be,extractPackageName as Ee,parseNpmLockfile as Pe,parsePnpmLockfile as Se,parseYarnLockfile as Ie}from"./packem_shared/extractPackageName-BeL6Gc3a.js";import{LogReporter as He,createLogReporter as Ae}from"./packem_shared/LogReporter-3R3oWj-Q.js";import{isNativeAvailable as De,loadNativeBindings as _e}from"./packem_shared/isNativeAvailable-CkTjxb7P.js";import{resolveOutputs as Ge}from"./packem_shared/resolveOutputs-BBjdaraf.js";import{INPUT_URI_SCHEMES as Oe,InvalidInputUriError as Ue,looksLikeInputUri as Ve,parseInputUri as We}from"./packem_shared/INPUT_URI_SCHEMES-Csrd0tlg.js";import{buildEnhancedPath as ze,collectNodeModulesBinDirs as Ye,withEnhancedPath as qe}from"./packem_shared/collectNodeModulesBinDirs-CD-eDrtO.js";import{enforceProjectConstraints as Ke}from"./packem_shared/enforceProjectConstraints-dNc1SwRi.js";import{generateRunSummary as Xe,getLastRunSummaryPath as Ze,readLastRunSummary as $e,writeLastRunSummary as er,writeRunSummary as rr}from"./packem_shared/generateRunSummary-L9Z2NfWn.js";import{createTaskGraph as tr,getTaskId as ar,parseTaskId as sr}from"./packem_shared/createTaskGraph-BBG8Rosl.js";import{findCycle as nr,findCycles as mr,getDependentTasks as ir,getLeafTasks as cr,getTransitiveDependencies as fr,makeAcyclic as lr,reverseTaskGraph as xr,walkTaskGraph as hr}from"./packem_shared/findCycle-BY8-jmzB.js";import{InProcessTaskHasher as ur,computeTaskHash as kr}from"./packem_shared/computeTaskHash-CaPdG1BA.js";import{TaskOrchestrator as Cr}from"./packem_shared/TaskOrchestrator-CYj5MLwz.js";import{TaskScheduler as yr,parsePartition as Rr}from"./packem_shared/parsePartition-Bt1jBjZH.js";import{TerminalBuffer as Fr}from"./packem_shared/TerminalBuffer-BtZy7TpT.js";import{T as br}from"./packem_shared/tracked-executor-B90U4Um3.js";import{d as Pr,j as Sr,T as Ir,b as Lr,E as Hr,v as Ar,h as wr,O as Dr}from"./packem_shared/utils-BH2W5Wml.js";import{evaluateWhen as Mr,explainWhen as Gr,getCurrentBranch as Nr,resetBranchCache as Or}from"./packem_shared/getCurrentBranch-D-qoZByx.js";import{getMainWorktreeRoot as Vr,isLinkedWorktree as Wr,resetWorktreeCache as jr}from"./packem_shared/getMainWorktreeRoot-DB9P2wDL.js";import{createInputHandler as Yr}from"./packem_shared/createInputHandler-CkDCpPYy.js";import{expandArguments as Jr}from"./packem_shared/expandArguments-D7qvc6Rp.js";import{expandShortcut as Qr}from"./packem_shared/expandShortcut-BErNHNXZ.js";import{expandTokens as Zr,expandTokensInString as $r}from"./packem_shared/expandTokensInString-DVSFEdWu.js";import{expandWildcard as ro}from"./packem_shared/expandWildcard-DE0dOOZF.js";import{formatTimingTable as to,logTimings as ao}from"./packem_shared/formatTimingTable-CP3rsDwf.js";import{runTeardown as po}from"./packem_shared/runTeardown-DAn1xFWJ.js";import{stripQuotes as mo}from"./packem_shared/stripQuotes-jkZb0CL9.js";import{withRestart as co}from"./packem_shared/withRestart-DKtEGsQA.js";export{R as Cache,Re as CompositeLifeCycle,ve as ConsoleLifeCycle,v as DEFAULT_CACHE_DIRECTORY_NAME,Fe as EmptyLifeCycle,se as FileAccessTracker,me as FingerprintManager,T as HttpRemoteCache,Oe as INPUT_URI_SCHEMES,ur as InProcessTaskHasher,ge as IncrementalFileHasher,Ue as InvalidInputUriError,be as LockfileHasher,He as LogReporter,g as ReapiRemoteCache,Cr as TaskOrchestrator,yr as TaskScheduler,Fr as TerminalBuffer,br as TrackedTaskExecutor,I as V2_AC,L as V2_CAS,H as V2_INDEX,A as V2_ROOT,w as V2_TMP,D as acEntryPath,x as actionDigestForTaskHash,ze as buildEnhancedPath,o as buildForwardDependencyMap,t as buildReverseDependencyMap,_ as casBlobPath,Pr as collectFiles,Ye as collectNodeModulesBinDirs,kr as computeTaskHash,N as containsBlob,h as containsByTaskHash,Sr as createFailureResult,Yr as createInputHandler,Ae as createLogReporter,i as createRemoteCacheBackend,tr as createTaskGraph,re as defaultTaskRunner,ce as detectFrameworks,te as detectScriptShell,E as digestBuffer,P as digestFile,Ke as enforceProjectConstraints,Mr as evaluateWhen,a as expandAffected,Jr as expandArguments,Qr as expandShortcut,Zr as expandTokens,$r as expandTokensInString,ro as expandWildcard,Gr as explainWhen,Ee as extractPackageName,O as fetchBlobToFile,s as filterAffectedTasks,nr as findCycle,mr as findCycles,F as formatCacheSize,to as formatTimingTable,pe as generatePreloadScript,Xe as generateRunSummary,p as getAffectedProjects,n as getChangedFiles,Nr as getCurrentBranch,ir as getDependentTasks,fe as getFrameworkEnvVariables,Ze as getLastRunSummaryPath,cr as getLeafTasks,Vr as getMainWorktreeRoot,ar as getTaskId,fr as getTransitiveDependencies,Ir as hashFile,Lr as hashStrings,le as inferFrameworkEnvPatterns,Wr as isLinkedWorktree,De as isNativeAvailable,_e as loadNativeBindings,ao as logTimings,Ve as looksLikeInputUri,lr as makeAcyclic,B as parseCacheSize,K as parseCommands,We as parseInputUri,Pe as parseNpmLockfile,Rr as parsePartition,Se as parsePnpmLockfile,sr as parseTaskId,Ie as parseYarnLockfile,he as projectGraphToDot,U as putBlobFromBytes,V as putBlobFromFile,$e as readLastRunSummary,Hr as readPackageDeps,Or as resetBranchCache,jr as resetWorktreeCache,c as resolveCacheMode,Ge as resolveOutputs,Ar as resolveTaskCwd,f as resolveTurboEnvCompat,d as retrieveByTaskHash,xr as reverseTaskGraph,$ as runConcurrentFallback,X as runConcurrently,po as runTeardown,wr as sortObjectKeys,u as storeByTaskHash,mo as stripQuotes,M as taskHashIndexPath,Y as toChromeTrace,de as toGraphAscii,ue as toGraphHtml,ke as toGraphJson,Te as toGraphvizDot,W as touchBlob,Dr as uniqueId,j as verifyBlob,hr as walkTaskGraph,qe as withEnhancedPath,co as withRestart,q as writeChromeTrace,er as writeLastRunSummary,rr as writeRunSummary};

package/dist/packem_shared/Cache-BVrj9bd4.js

@@ -0,0 +1,2 @@
+var I=Object.defineProperty;var b=(s,t)=>I(s,"name",{value:t,configurable:!0});import{createRequire as R}from"node:module";import{parseBytes as X,formatBytes as Y}from"@visulima/humanizer";import{dirname as N,join as u,resolve as x}from"@visulima/path";import{a as G,b as K}from"./archive-CDfGy5Lm.js";import{O as m}from"./utils-BH2W5Wml.js";import{acEntryPath as A,tmpDirectory as B,taskHashIndexPath as z,V2_ROOT as _}from"./V2_ROOT-injxWBrl.js";import{fetchBlobToFile as L,containsBlob as U,putBlobFromFile as Z}from"./containsBlob-DAU8R7GH.js";import{resolveOutputs as Q}from"./resolveOutputs-BBjdaraf.js";const J=R(import.meta.url),k=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,E=b(s=>{if(typeof k<"u"&&k.versions&&k.versions.node){const[t,e]=k.versions.node.split(".").map(Number);if(t>22||t===22&&e>=3||t===20&&e>=16)return k.getBuiltinModule(s)}return J(s)},"__cjs_getBuiltinModule"),{createWriteStream:H}=E("node:fs"),{mkdir:f,writeFile:d,rename:w,rm:l,readFile:v,utimes:q,open:V,stat:O,readdir:S,cp:D}=E("node:fs/promises"),{pipeline:W}=E("node:stream/promises");var tt=Object.defineProperty,C=b((s,t)=>tt(s,"name",{value:t,configurable:!0}),"s");const et=C(async(s,t,e)=>{const r=A(s,t),a=B(s),i=`${a}/${m()}`;await f(a,{recursive:!0}),await f(N(r),{recursive:!0});const n=`${JSON.stringify(e,null,2)}
+`;await d(i,n);try{await w(i,r)}catch(c){throw await l(i,{force:!0}).catch(()=>{}),c}},"writeActionEntry"),at=C(async(s,t)=>{const e=A(s,t);try{const r=await v(e,"utf8"),a=JSON.parse(r),i=new Date;return await q(e,i,i).catch(()=>{}),a}catch{return null}},"readActionEntry"),rt=C(async(s,t,e)=>{const r=z(s,t),a=B(s),i=`${a}/${m()}`;await f(a,{recursive:!0}),await f(N(r),{recursive:!0}),await d(i,e);try{await w(i,r)}catch(n){throw await l(i,{force:!0}).catch(()=>{}),n}},"writeTaskHashIndex"),st=C(async(s,t)=>{try{const e=(await v(z(s,t),"utf8")).trim();return e.length>0?e:null}catch{return null}},"readTaskHashIndex");var it=Object.defineProperty,y=b((s,t)=>it(s,"name",{value:t,configurable:!0}),"d");const ct=10080*60*1e3,nt=".task-runner-cache",ot=y(s=>{if(s.includes("\0"))throw new Error("cacheNamespace: null bytes are not allowed.");if(s.includes("/")||s.includes("\\"))throw new Error(`cacheNamespace: path separators are not allowed (received ${JSON.stringify(s)}).`);if(s==="."||s==="..")throw new Error(`cacheNamespace: "${s}" would escape the cache subtree.`)},"assertSafeNamespace"),$=y(async s=>{try{await l(s,{force:!0,recursive:!0})}catch{}},"removeEntry"),j=y(async s=>{let t=0;try{const e=await S(s,{withFileTypes:!0});for(const r of e){const a=u(s,r.name);if(r.isDirectory())t+=await j(a);else if(r.isFile()){const i=await O(a);t+=i.size}}}catch{}return t},"getDirectorySize"),ut=y(s=>{const t=X(s.trim());if(Number.isNaN(t))throw new TypeError(`Invalid cache size format: "${s}". Expected format like "500MB" or "1GB".`);return t},"parseCacheSize"),kt=y(s=>Y(s,{decimals:1,space:!1}),"formatCacheSize");class Ot{static{b(this,"Z")}static{y(this,"Cache")}#e;#t;#r;#a;#s=Promise.resolve();constructor(t){this.#e=t.workspaceRoot;const e=t.cacheDirectory??u(t.workspaceRoot,nt);t.cacheNamespace!==void 0&&t.cacheNamespace.length>0&&ot(t.cacheNamespace),this.#t=t.cacheNamespace&&t.cacheNamespace.length>0?u(e,"ns",t.cacheNamespace):e,this.#r=t.maxCacheAge??ct,this.#a=t.maxCacheSize?ut(t.maxCacheSize):void 0}get cacheDirectory(){return this.#t}get casRoot(){return this.#t}async getActionResult(t){return at(this.#t,t.hash)}async resolveActionDigestForTaskHash(t){return st(this.#t,t)}async putActionResult(t,e,r,a){await this.#i(a),await et(this.#t,e.hash,r),await rt(this.#t,t,e.hash)}async materializeOutputs(t,e){for(const r of t.outputFiles){const a=x(e,r.path);if(!await L(this.#t,r.digest,a))return!1}return!0}async#i(t){for(const e of t){if(await U(this.#t,e.digest))continue;const r=u(this.#t,_,"tmp",`.put-${m()}`);await f(N(r),{recursive:!0});const a=await e.open();await W(a,H(r)),await Z(this.#t,e.digest,r),await l(r,{force:!0}).catch(()=>{})}}async get(t){const e=u(this.#t,t);try{await v(u(e,".commit"));const r=await v(u(e,"code"),"utf8"),a=Number.parseInt(r.trim(),10);if(Number.isNaN(a))return;let i="";try{i=await v(u(e,"terminalOutput"),"utf8")}catch{}let n;try{const c=await v(u(e,"fingerprint.json"),"utf8");n=JSON.parse(c)}catch{}return{code:a,fingerprint:n,hash:t,terminalOutput:i}}catch{return}}async put(t,e,r,a,i,n){const c=u(this.#t,t),h=u(this.#t,`.tmp-${t}-${m()}`);try{await f(h,{recursive:!0});const o=[d(u(h,"code"),String(a)),d(u(h,"terminalOutput"),e),this.#o(h,r,n)];i&&o.push(d(u(h,"fingerprint.json"),JSON.stringify(i))),await Promise.all(o),await d(u(h,".commit"),"");const p=`${c}.trash-${m()}`;let g=!1;try{await w(c,p),g=!0}catch{}try{await w(h,c)}catch(F){throw g&&await w(p,c).catch(()=>{}),F}g&&$(p).catch(()=>{})}catch{await $(h)}}async restoreOutputs(t,e,r){const a=u(this.#t,t);return lt(a,this.#e,r)}async getByTaskId(t){const e=u(this.#t,".task-index.json");try{const r=await v(e,"utf8"),a=JSON.parse(r)[t];return a?this.get(a):void 0}catch{return}}async setTaskIndex(t,e){const r=this.#s.then(()=>this.#c(t,e));return this.#s=r.catch(()=>{}),r}async#c(t,e){const r=u(this.#t,".task-index.json"),a=u(this.#t,`.task-index-${m()}.tmp`);await f(this.#t,{recursive:!0}),await this.#n(async()=>{let i={};try{const n=await v(r,"utf8");i=JSON.parse(n)}catch{}i[t]=e,await d(a,JSON.stringify(i));try{await w(a,r)}catch{await d(r,JSON.stringify(i)),await l(a,{force:!0})}})}async#n(t){const e=u(this.#t,".task-index.lock"),r=3e4,a=1e4,i=Date.now();for(;;){let n;try{n=await V(e,"wx")}catch(c){if(c.code!=="EEXIST")throw c;const h=await O(e).catch(()=>{});if(h&&Date.now()-h.mtimeMs>r){await l(e,{force:!0}).catch(()=>{});continue}if(Date.now()-i>a)throw new Error(`Timed out waiting for task-index lock at ${e}`,{cause:c});await new Promise(o=>{setTimeout(o,50)});continue}try{return await t()}finally{await n.close().catch(()=>{}),await l(e,{force:!0}).catch(()=>{})}}}async removeOldEntries(){try{const t=await S(this.#t),e=Date.now(),r=[];for(const a of t){if(a.startsWith(".")||a===_)continue;const i=u(this.#t,a);try{const n=await O(i);if(e-n.mtimeMs>this.#r)await $(i);else{const c=await j(i);r.push({mtimeMs:n.mtimeMs,name:a,path:i,size:c})}}catch{}}if(this.#a!==void 0){const a=r.toSorted((n,c)=>n.mtimeMs-c.mtimeMs);let i=0;for(const n of a)i+=n.size;for(const n of a){if(i<=this.#a)break;await $(n.path),i-=n.size}}}catch{}}async clear(){try{await l(this.#t,{force:!0,recursive:!0})}catch{}}async#o(t,e,r){await ht(this.#e,t,e,r)}}const M="outputs.tar.br",ht=y(async(s,t,e,r)=>{if(e.length===0)return;const a=await Q(s,e,r);if(a.length===0)return;const i=u(t,`.outputs-stage-${m()}`),n=u(t,M);try{if(await f(i,{recursive:!0}),(await T(P,a,async c=>{const h=x(s,c),o=u(i,c);try{return await f(N(o),{recursive:!0}),await D(h,o,{preserveTimestamps:!0,recursive:!0}),!0}catch{return!1}})).filter(Boolean).length===0)return;await K(i,n)}finally{await l(i,{force:!0,recursive:!0}).catch(()=>{})}},"archiveOutputsCompressed"),P=16,T=y(async(s,t,e)=>{const r=Array.from({length:t.length});let a=0;const i=y(async()=>{for(;a<t.length;){const c=a;a+=1,r[c]=await e(t[c],c)}},"worker"),n=Array.from({length:Math.min(s,t.length)},()=>i());return await Promise.all(n),r},"runBounded"),lt=y(async(s,t,e)=>{const r=u(s,M);try{await O(r)}catch{return!0}const a=u(s,`.restore-${m()}`),i=e?.preserveMtime??!0,n=[];try{await f(a,{recursive:!0}),await G(r,a,e);const c=(await S(a)).sort(),h=m();for(const o of c){const p=x(t,o);n.push({absoluteOutput:p,backupCreated:!1,backupPath:`${p}.old-${h}`,entry:o,installed:!1,prePositioned:`${p}.restoring-${h}`})}return await T(P,n,async o=>{const p=u(a,o.entry);await f(N(o.absoluteOutput),{recursive:!0}),await l(o.prePositioned,{force:!0,recursive:!0}).catch(()=>{});try{await w(p,o.prePositioned)}catch(g){if(g.code==="EXDEV")await D(p,o.prePositioned,{preserveTimestamps:i,recursive:!0});else throw g}}),await T(P,n,async o=>{try{await O(o.absoluteOutput)}catch{return}await w(o.absoluteOutput,o.backupPath),o.backupCreated=!0}),await T(P,n,async o=>{await w(o.prePositioned,o.absoluteOutput),o.installed=!0}),await Promise.all(n.filter(o=>o.backupCreated).map(({backupPath:o})=>l(o,{force:!0,recursive:!0}).catch(()=>{}))),!0}catch{for(const c of n)if(c.installed){const h=`${c.absoluteOutput}.failed-${m()}`;await w(c.absoluteOutput,h).catch(()=>{}),c.backupCreated&&await w(c.backupPath,c.absoluteOutput).catch(()=>{}),c.installed=!1,await l(h,{force:!0,recursive:!0}).catch(()=>{})}else c.backupCreated&&await w(c.backupPath,c.absoluteOutput).catch(()=>{});return!1}finally{await l(a,{force:!0,recursive:!0}).catch(()=>{});for(const c of n)await l(c.prePositioned,{force:!0,recursive:!0}).catch(()=>{}),!(c.backupCreated&&!c.installed)&&await l(c.backupPath,{force:!0,recursive:!0}).catch(()=>{})}},"restoreOutputsCompressed");export{Ot as Cache,nt as DEFAULT_CACHE_DIRECTORY_NAME,kt as formatCacheSize,ut as parseCacheSize};

package/dist/packem_shared/CompositeLifeCycle-C6aee9GK.js

@@ -0,0 +1 @@
+var r=Object.defineProperty;var n=(o,s)=>r(o,"name",{value:s,configurable:!0});var c=Object.defineProperty,i=n((o,s)=>c(o,"name",{value:s,configurable:!0}),"o");const l=i(o=>{switch(o){case"failure":return"[failure]";case"local-cache":case"local-cache-kept-existing":case"remote-cache":return"[cache]";case"skipped":return"[skipped]";case"success":return"[success]";default:return"[unknown]"}},"getStatusIcon");class d{static{n(this,"r")}static{i(this,"CompositeLifeCycle")}#s;constructor(s){this.#s=s}startCommand(){for(const s of this.#s)s.startCommand?.()}endCommand(){for(const s of this.#s)s.endCommand?.()}scheduleTask(s){for(const t of this.#s)t.scheduleTask?.(s)}startTasks(s){for(const t of this.#s)t.startTasks?.(s)}endTasks(s){for(const t of this.#s)t.endTasks?.(s)}printTaskTerminalOutput(s,t,e){for(const a of this.#s)a.printTaskTerminalOutput?.(s,t,e)}printCacheMiss(s,t){for(const e of this.#s)e.printCacheMiss?.(s,t)}printCacheDisabledByTask(s){for(const t of this.#s)t.printCacheDisabledByTask?.(s)}printEmptyFingerprintWarning(s,t){for(const e of this.#s)e.printEmptyFingerprintWarning?.(s,t)}printSelfModifyingSkip(s,t){for(const e of this.#s)e.printSelfModifyingSkip?.(s,t)}onTaskStdout(s,t){for(const e of this.#s)e.onTaskStdout?.(s,t)}onTaskStderr(s,t){for(const e of this.#s)e.onTaskStderr?.(s,t)}}class u{static{n(this,"l")}static{i(this,"ConsoleLifeCycle")}#s;constructor(s=!1){this.#s=s}startCommand(){this.#s&&console.log("[task-runner] Starting command execution")}endCommand(){this.#s&&console.log("[task-runner] Command execution complete")}scheduleTask(s){this.#s&&console.log(`[task-runner] Scheduled: ${s.id}`)}startTasks(s){for(const t of s)console.log(`> ${t.id}`)}endTasks(s){for(const t of s){const e=t.startTime&&t.endTime?` (${t.endTime-t.startTime}ms)`:"",a=l(t.status);console.log(`${a} ${t.task.id}${e}`)}}printTaskTerminalOutput(s,t,e){e.trim()&&console.log(e)}printCacheMiss(s,t){this.#s&&console.log(`[task-runner] ${s.id}: ${t}`)}}class h{static{n(this,"u")}static{i(this,"EmptyLifeCycle")}}export{d as CompositeLifeCycle,u as ConsoleLifeCycle,h as EmptyLifeCycle};