turbo 2.11.8-canary.2 → 2.11.8

package/docs/guides/ai.mdx

@@ -18,7 +18,7 @@ Turborepo configuration, task behavior, and CLI commands can vary between instal
 
 The block tells agents to resolve the `turbo` package from the repository or relevant workspace instead of assuming it is at the root `node_modules/turbo`. It points them to that package's `docs/README.md` first, then to the relevant pages under `docs/`. These bundled pages match the installed version and work without network access.
 
-Turborepo creates `AGENTS.md` if needed and updates only its uniquely marked block, preserving existing project instructions and other tools' managed blocks. The block is re-added before repository-scoped commands when an agent is detected. Set `"agentGuidance": false` in the root `turbo.json` or `turbo.jsonc` to opt out; this does not remove an existing block. Keep the generated block committed with your work to avoid an uncommitted change on a later agent invocation. New projects created from the default starter include it from the start.
+Turborepo creates `AGENTS.md` if needed and updates only its uniquely marked block, preserving existing project instructions and other tools' managed blocks. Set `"agentGuidance": true` in the root `turbo.json` or `turbo.jsonc` to opt in; this does not remove an existing block. Keep the generated block committed with your work to avoid an uncommitted change on a later agent invocation. New projects created from the default starter include it from the start.
 
 ## Agent Skill
 

package/docs/guides/tools/python.mdx

@@ -148,7 +148,7 @@ With zero configuration, Turborepo creates task hashes using:
 
 - The selected member's source files, plus its internal dependency sources for `check` and `test`
 - Every member's source files when verification runs through the workspace package, and the whole repository for a root pytest task because pytest controls collection
-- Root uv files (`pyproject.toml`, `uv.toml`, `.python-version`) and supported tool configuration such as `ruff.toml`, `mypy.ini`, `pyrightconfig.json`, `pytest.ini`, and `ty.toml`
+- Root uv files (`pyproject.toml`, `uv.toml`, `.python-version`) and supported tool configuration such as `ruff.toml`, `mypy.ini`, `pyrightconfig.json`, `pytest.ini`, and `ty.toml`. Ruff and pytest configuration (including `conftest.py`) in directories between the root and a member are included too.
 - Relevant uv and pip environment variables
 - The resolved external dependency closure from `uv.lock`, scoped to each member
 - The uv and Python interpreter identities. If Turborepo cannot resolve them, uv tasks remain runnable but implicit caching is disabled with a warning.

package/docs/guides/tools/rust.mdx

@@ -152,9 +152,42 @@ The built-in `format` task also includes `rustfmt.toml`, `.rustfmt.toml`, and `R
 
 Project-specific hashing inputs must be accounted for manually. This includes:
 
-- Environment variables must read by build scripts still need to be declared in the task's [`env`](/docs/reference/configuration#env) configuration
+- Environment variables read by build scripts still need to be declared in the task's [`env`](/docs/reference/configuration#env) configuration
 - File inputs that are not included by default. Use [`inputs`](/docs/reference/configuration#inputs) to define your own file inputs and [`$TURBO_DEFAULT$`](/docs/reference/configuration#turbo_default) to preserve zero-configuration file inputs
 
+Files that a crate reads from outside its own directory and outside its local dependency crates are not part of the default inputs. Common sources are:
+
+- `include_str!`, `include_bytes!`, and `include!` with a path that leaves the crate, such as `include_str!("../../shared/schema.json")` or a path built from `env!("CARGO_MANIFEST_DIR")`
+- `#[path = "..."]` modules outside the crate
+- Build scripts that read files elsewhere in the repository (these also need `cargo:rerun-if-changed` for Cargo itself)
+
+Without a declaration, editing such a file does not change the task hash, and Turborepo restores the previous result from cache. Declaring the files on one crate's task is not enough: every task that compiles the crate reads them too, including the tasks of crates that depend on it and workspace-wide `test`, `check`, and `lint`. Declare them on each of those tasks:
+
+```json title="./turbo.json"
+{
+  "tasks": {
+    "build": {
+      "inputs": ["$TURBO_DEFAULT$", "$TURBO_ROOT$/shared/schema/**"]
+    },
+    "test": {
+      "inputs": ["$TURBO_DEFAULT$", "$TURBO_ROOT$/shared/schema/**"]
+    },
+    "check": {
+      "inputs": ["$TURBO_DEFAULT$", "$TURBO_ROOT$/shared/schema/**"]
+    },
+    "lint": {
+      "inputs": ["$TURBO_DEFAULT$", "$TURBO_ROOT$/shared/schema/**"]
+    }
+  }
+}
+```
+
+In a repository that also has JavaScript packages, these task-wide keys apply to those packages as well. That is safe but causes extra cache misses. To avoid it, declare the inputs as `<package>#<task>` entries for each affected crate instead.
+
+Explicit input globs hash files from the filesystem, including gitignored ones, so keep them narrow. A glob over a whole package directory also picks up its `.turbo` logs, `node_modules`, and build output.
+
+To find these files, check the `.d` dep-info file Cargo writes next to each build artifact (for example, `target/debug/my-crate.d`). It lists every file the compile read, including files read by dependency crates. It only exists after Cargo has actually compiled the crate, not after Turborepo restored it from cache.
+
 ### Output caching
 
 Automatic output caching stores only the exact final `bin`, `cdylib`, and `staticlib` deliverables. It does not cache Cargo's incremental `target/` state or use profile or target wildcards.

package/docs/reference/configuration.mdx

@@ -117,19 +117,19 @@ When set to `true`, disables the update notification that appears when a new ver
 
 ### `agentGuidance`
 
-Default: `true`
+Default: `false`
 
-When an AI coding agent is detected, `turbo` maintains a managed block in the repository-root `AGENTS.md` that points to the documentation bundled with the installed `turbo` package. The guidance is refreshed before repository-scoped commands, and only Turborepo's own block is updated. Existing instructions and other tools' blocks are preserved.
+When an AI coding agent is detected, `turbo` can maintain a managed block in the repository-root `AGENTS.md` that points to the documentation bundled with the installed `turbo` package. The guidance is refreshed before repository-scoped commands, and only Turborepo's own block is updated. Existing instructions and other tools' blocks are preserved.
 
-This is a root-only option; it cannot be set in package-level `turbo.json` files. Use it in either `turbo.json` or `turbo.jsonc` to stop future automatic updates:
+This is a root-only option; it cannot be set in package-level `turbo.json` files. Use it in either `turbo.json` or `turbo.jsonc` to opt in to automatic updates:
 
 ```json title="./turbo.json"
 {
-  "agentGuidance": false
+  "agentGuidance": true
 }
 ```
 
-Opting out does not delete an existing `AGENTS.md` file or Turborepo block. Existing repositories receive the guidance on a later `turbo` invocation when an agent is detected. New projects created from the default starter include it immediately.
+Opting out does not delete an existing `AGENTS.md` file or Turborepo block. Existing repositories receive or refresh the guidance only after opting in. New projects created from the default starter include it immediately.
 
 ### `concurrency`
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "turbo",
-  "version": "2.11.8-canary.2",
+  "version": "2.11.8",
   "description": "Turborepo is the build system for coding agents.",
   "homepage": "https://turborepo.dev",
   "bugs": "https://github.com/vercel/turborepo/issues",
@@ -19,12 +19,12 @@
   ],
   "main": "./bin/turbo",
   "optionalDependencies": {
-    "@turbo/darwin-64": "2.11.8-canary.2",
-    "@turbo/darwin-arm64": "2.11.8-canary.2",
-    "@turbo/linux-64": "2.11.8-canary.2",
-    "@turbo/linux-arm64": "2.11.8-canary.2",
-    "@turbo/windows-64": "2.11.8-canary.2",
-    "@turbo/windows-arm64": "2.11.8-canary.2"
+    "@turbo/darwin-64": "2.11.8",
+    "@turbo/darwin-arm64": "2.11.8",
+    "@turbo/linux-64": "2.11.8",
+    "@turbo/linux-arm64": "2.11.8",
+    "@turbo/windows-64": "2.11.8",
+    "@turbo/windows-arm64": "2.11.8"
   },
   "scripts": {
     "postversion": "node bump-version.js"

package/schema.json

@@ -16,7 +16,7 @@
       ]
     },
     "agentGuidance": {
-      "description": "Controls whether turbo maintains a root `AGENTS.md` block for AI agents.\n\nDefaults to `true`. Set to `false` to opt out of future automatic updates.",
+      "description": "Controls whether turbo maintains a root `AGENTS.md` block for AI agents.\n\nDefaults to `false`. Set to `true` to opt in to future automatic updates.",
       "anyOf": [
         {
           "$ref": "#/definitions/Boolean"