chore: Deprecate the turbo scan command

Cargo.toml

@@ -55,7 +55,6 @@ turborepo-cache = { path = "crates/turborepo-cache" }
 turborepo-ai-agents = { path = "crates/turborepo-ai-agents" }
 turborepo-ci = { path = "crates/turborepo-ci" }
 turborepo-daemon = { path = "crates/turborepo-daemon" }
-turborepo-diagnostics = { path = "crates/turborepo-diagnostics" }
 turborepo-engine = { path = "crates/turborepo-engine" }
 turborepo-env = { path = "crates/turborepo-env" }
 turborepo-errors = { path = "crates/turborepo-errors" }

apps/docs/content/docs/reference/index.mdx

@@ -108,9 +108,9 @@ Turborepo's API reference is broken up into the following sections:
     />
 
     <Card
-        title="scan"
+        title="scan (Deprecated)"
         href="/docs/reference/scan"
-        description="Enable the fastest defaults for your Turborepo."
+        description="Deprecated. Will be removed in a future major version."
     />
 
     <Card

apps/docs/content/docs/reference/scan.mdx

@@ -1,22 +1,12 @@
 ---
-title: scan
-description: API reference for the `turbo scan` command
+title: scan (Deprecated)
+description: API reference for the deprecated `turbo scan` command
 product: turborepo
 type: reference
-summary: Reference for the `turbo scan` command that interactively enables performance optimizations.
+summary: The `turbo scan` command has been deprecated and will be removed in a future major version.
 ---
 
-Enable faster tooling for your Turborepo locally with one, interactive command.
-
-```bash title="Terminal"
-turbo scan
-```
-
-You'll be taken through a short series of steps to enable the fastest settings for your Turborepo. These optimizations include:
-
-- **Git FS Monitor**: `turbo` leans on Git to do file change discovery. Since we have to wait for `git` to tell us about changes, we can use [Git's built-in filesystem monitor](https://git-scm.com/docs/git-fsmonitor--daemon) to get those notifications sooner.
-- **Turborepo Daemon** (deprecated for `turbo run`): Turborepo's daemon is no longer used for `turbo run`. It is still used by `turbo watch` and the Turborepo LSP.
-- **Remote Caching**: While Turborepo can cache your work locally, it can also share a cache across all of your machines. Enabling [Remote Caching](/docs/core-concepts/remote-caching) makes your caching **multiplayer**, ensuring that you, your teammates, and your CI machines, never do the same work twice.
-- **Check `turbo` version**: We're always working towards making `turbo` better. To ensure you are using the latest version of Turborepo, we'll check your version and remind you to install `latest` if you aren't using it yet.
-- **Check for Turborepo LSP**:
-  Visit the [VSCode Extension Marketplace](https://marketplace.visualstudio.com/items?itemName=Vercel.turbo-vsc) and install the Turborepo LSP extension for your IDE.
+<Callout type="warn" title="Deprecated">
+  `turbo scan` has been deprecated and will be removed in a future major version.
+  Running it will print a deprecation warning and exit.
+</Callout>

apps/docs/content/docs/support-policy.mdx

@@ -120,3 +120,4 @@ Deprecated APIs are in the process of being removed. Any feature we intend to re
 - `TURBO_REMOTE_ONLY` and `--remote-only`: Use [`TURBO_CACHE`](/docs/reference/system-environment-variables) or [--cache](/docs/reference/run#--cache-options)
 - `--scope` for [`turbo prune`](/docs/reference/prune): Use positional arguments instead (e.g. `turbo prune web`)
 - `--graph` with `.png`, `.jpg`, `.pdf`, or `.json` output: These formats require an external Graphviz installation and will be removed in version 3.0. Use `.svg`, `.html`, `.mermaid`, or `.dot` instead. For programmatic access to the task graph, use [`turbo query`](/docs/reference/query).
+- [`turbo scan`](/docs/reference/scan): This command has been removed and will be fully deleted in a future major version.