feat: Add global configuration key behind futureFlags.globalConfiguration#12399
Merged
anthonyshew merged 7 commits intomainfrom Mar 20, 2026
Merged
feat: Add global configuration key behind futureFlags.globalConfiguration#12399anthonyshew merged 7 commits intomainfrom
global configuration key behind futureFlags.globalConfiguration#12399anthonyshew merged 7 commits intomainfrom
Conversation
…uration` Introduces a nested `global` key in turbo.json that replaces scattered top-level global settings (globalDependencies, globalEnv, ui, etc.). The key behavioral change: `global.inputs` are prepended to every task's inputs instead of being folded into the global hash. This allows tasks to exclude specific global files via negation globs — something impossible with `globalDependencies`.
Contributor
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Explains how global.inputs files are folded into per-task hashes (instead of the global hash), enabling tasks to exclude specific global files via negation globs.
Two issues: - app-b fixture used inputs: ["**"] which matched .turbo/ cache artifacts, causing spurious misses on second run. Changed to $TURBO_DEFAULT$ which respects .gitignore. - Assertions checked for "app-a#build" but turbo output uses "app-a:build:" format.
…affected detection Phantom tasks (packages without a matching script that exist as dependency nodes via `dependsOn: ["^task"]`) were getting global input files prepended to their inputs. When a global input changed, these phantom hashes changed and cascaded into downstream tasks via task_dependency_hashes — defeating per-task negation globs. Additionally, scope/affected resolution was using global_deps_for_hash() which returns empty when globalConfiguration is on, breaking --affected detection for global input file changes.
github-actions Bot
added a commit
that referenced
this pull request
Mar 28, 2026
## Release v2.8.21 Versioned docs: https://v2-8-21.turborepo.dev ### Changes - release(turborepo): 2.8.20 (#12396) (`45230ec`) - fix: Disable husky hooks in `update-examples` workflow (#12397) (`56b79ff`) - docs: Add link to Docker guide in prune --docker flag section (#12401) (`e7f0db7`) - feat: Add `global` configuration key behind `futureFlags.globalConfiguration` (#12399) (`5f190cf`) - chore: Update CODEOWNERS to remove /docs owner (#12402) (`3233d3a`) - fix: Strip JSX components from heading anchors and TOC entries (#12404) (`3abe553`) - fix: Move docs app icons into app/ directory (#12403) (`ddf3918`) - feat: Add experimental structured logging with `--json` and `--log-file` flags (#12405) (`7ca0601`) - release(turborepo): 2.8.21-canary.1 (#12407) (`adebb95`) - docs: Downgrade Next.js (#12408) (`281e89b`) - chore: Deprecate the `turbo scan` command (#12406) (`4a12c26`) - release(turborepo): 2.8.21-canary.2 (#12409) (`b9ef212`) - fix(eslint-plugin-turbo): Guard against missing tasks/pipeline in forEachTaskDef (#12411) (`6c107c2`) - release(turborepo): 2.8.21-canary.3 (#12413) (`a2e6635`) - chore: Upgrade Next.js (#12415) (`b9e6174`) - Revert "fix: Flush stale mouse tracking events from stdin during TUI cleanup" (#12416) (`646b06e`) - fix: Add NixOS environment variables to default passthroughs (#12417) (`4f12c69`) - release(turborepo): 2.8.21-canary.4 (#12419) (`19cb539`) - fix: Resolve security vulnerabilities in `tar` and `rustls-webpki` (#12418) (`f09b138`) - release(turborepo): 2.8.21-canary.5 (#12420) (`8aca047`) - docs: Promote `turbo query` from experimental to stable (#12421) (`0692aba`) - docs: Clarify `turbo-ignore`'s future (#12422) (`c5a8235`) - release(turborepo): 2.8.21-canary.6 (#12423) (`3ebf536`) - feat: Rework turbo ls to use query internals and add turbo query ls shorthand (#12424) (`84fd6e3`) - docs: Clarify environment variables across packages dependency behavior (#12390) (`e44b0d8`) - docs: Expand subpath imports example (#12412) (`a7fec57`) - fix(examples): Update of `with-svelte` example (#11952) (`41d1b2e`) - release(turborepo): 2.8.21-canary.7 (#12425) (`7155a67`) - fix: Preserve source dependencies when adding workspace deps in `turbo-gen` (#11935) (`01c56cc`) - docs: Add Git history requirements to `turbo query affected` docs (#12426) (`edc16d5`) - fix: Prevent horizontal overflow from long inline code on narrow viewports (#12428) (`a5d641b`) - release(turborepo): 2.8.21-canary.8 (#12429) (`46814d0`) - feat: Send git SHA and dirty hash to remote cache (#12427) (`192034a`) - fix: Upgrade tokio to 1.47.1+ to fix pidfd_reaper panic (#12431) (`8c25d47`) - release(turborepo): 2.8.21-canary.9 (#12432) (`2e2f8c3`) - fix: Use script-shell=bash for cross-platform with-shell-commands example (#12436) (`d5c2192`) - docs: Add AI guide to sidebar navigation (#12438) (`021d288`) - docs: Move `experimentalObservability` into `futureFlags` section (#12439) (`85812cc`) - fix: Skip Unix domain sockets and other special files during file hashing (#12445) (`eb8f75e`) - fix: Preserve dedupePeers and unknown pnpm lockfile settings (#12443) (`1529b92`) - release(turborepo): 2.8.21-canary.10 (#12446) (`014111c`) - fix: Align dry run cache status with normal run by checking caching guards (#12448) (`48aa171`) - release(turborepo): 2.8.21-canary.11 (#12450) (`b14aa0b`) - fix: Resolve turbo watch hang with mixed interruptible persistent tasks (#12449) (`326532d`) - release(turborepo): 2.8.21-canary.12 (#12451) (`379d47b`) - fix: Avoid `setsid()` in PTY spawn to prevent macOS Gatekeeper CPU spikes (#12452) (`dcc9f6a`) - release(turborepo): 2.8.21-canary.13 (#12453) (`19f46e6`) - feat: Add `packagesFromLockfile()` NAPI binding to `@turbo/repository` (#12454) (`c58ee79`) - release(library): 0.0.1-canary.21 (#12455) (`3637185`) - release(turborepo): 2.8.21-canary.14 (#12456) (`3f87769`) - refactor: Move cache hit SHA context to verbose logging (#12435) (`23c15b4`) - release(turborepo): 2.8.21-canary.15 (#12457) (`6353482`) - docs: Add missing --force flag documentation (#12440) (`e3b89b0`) - fix: Prevent panic in turbo watch with persistent tasks (#12459) (`337b2e8`) - release(turborepo): 2.8.21-canary.16 (#12461) (`e79a56b`) - fix: Support `turbo watch` in single-package workspaces (#12460) (`ae78ce1`) - release(turborepo): 2.8.21-canary.17 (#12463) (`0bafae2`) - fix: Missing deps after npm lockfile parsing (#12464) (`fe5a86e`) - release(turborepo): 2.8.21-canary.18 (#12465) (`c014134`) - docs: Add AI agent detection and automatic markdown rewrites (#12462) (`50bd872`) - fix: Resolve generator name conflicts across workspaces (#12467) (`d5d37a8`) - release(turborepo): 2.8.21-canary.19 (#12468) (`7552e93`) - fix: Remove root package.json from `--affected` global triggers (#12469) (`91ebb97`) - release(turborepo): 2.8.21-canary.20 (#12470) (`c5a4690`) - fix: Show run summary after TUI exits (#12471) (`ffa47d1`) --------- Co-authored-by: Turbobot <turbobot@vercel.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
futureFlags.globalConfigurationflag that moves scattered global settings (globalDependencies,globalEnv,ui,envMode, etc.) under a dedicatedglobalkey inturbo.jsonglobal.inputsare prepended to every task'sinputsinstead of being folded into the global hash, allowing tasks to opt out of specific global files via negation globs (e.g.!$TURBO_ROOT$/config.txt)globalkey with legacy top-level global keys (and vice versa)Why
Today,
globalDependenciesfiles affect the global hash, meaning a change to any global file invalidates every task's cache — even tasks that explicitly exclude the file via negation globs. This is a common pain point.By treating global files as per-task inputs instead, tasks gain the ability to exclude specific global files, giving users fine-grained control over cache invalidation without losing the "these files matter everywhere" default.
How to test
The integration tests in
crates/turborepo/tests/global_inputs_test.rsdemonstrate the key behavioral difference:test_global_dependencies_cannot_be_excluded_by_task_inputs— Proves that with the oldglobalDependencies, changing a global file invalidates all tasks regardless of negation globstest_global_inputs_can_be_excluded_by_task_inputs— Proves that with the newglobal.inputs, a task that excludes the file via!$TURBO_ROOT$/config.txtgets a cache hit even after the file changestest_global_inputs_preserves_default_package_file_hashing— Proves that tasks without explicitinputsstill hash their package files alongside global inputsExample
turbo.jsonusing the new format:{ "futureFlags": { "globalConfiguration": true }, "global": { "inputs": ["tsconfig.json"], "env": ["CI"], "ui": "tui" }, "tasks": { "build": {} } }