Configuration

All options are passed to defaultTaskRunner as the second argument.

Caching

Targets

These keys live on a TargetConfiguration (under targetDefaults or a project's own targets) and are carried onto each Task at graph creation.

when

when accepts the following predicates. All positive clauses must match (AND); array values mean any-of (OR). not.* mirrors apply the inverse.

when: { os: ["linux", "darwin"], ci: true, env: { name: "DEPLOY_TOKEN", exists: true } }

Tasks whose when returns false are recorded with status "skipped" (not "failure") and never reach the executor.

always-tasks

Targets marked always: true run sequentially after the main task graph completes, even if upstream tasks failed. They:

• bypass the cache (no lookup, no fingerprint, no store) — cleanup tasks are expected to run every invocation;
• still honour when, so a notify-on-deploy task can stay branch-gated;
• are skipped on SIGINT — the user's explicit ask is to stop now;
• are not part of the dependency graph and never block other tasks.

warningPattern & cacheOnWarning

warningPattern is one or more JavaScript regex sources scanned against the task's combined terminal output after a 0-exit. The first match sets TaskResult.hadWarnings = true. With cacheOnWarning: false, a warning-tainted run still surfaces hadWarnings but is not written to the local or remote cache.

build: {
    warningPattern: ["\\bwarning\\b", "TS\\d{4}"],
    cacheOnWarning: false,
}

outputs

Each entry is one of:

Resolved paths are deduped, sorted, and filtered to files inside the workspace before archiving.

cacheRestore

Per-target overrides for how cached outputs are rehydrated.

Flip individually when downstream tooling needs the legacy "now"-stamped behaviour (e.g. bundlers that use newer-than-source heuristics).

Inputs

Auto-Fingerprinting

Execution

Remote Cache

The earlier read / write boolean pair was removed in favor of mode. There is no automatic migration — translate manually:

// before
remoteCache: { url, token, read: true, write: false }
// after
remoteCache: { url, token, mode: "read" }

Output