From 22b8be39d01b978e4f50eb736112f4a6dfa28feb Mon Sep 17 00:00:00 2001
From: "aspire-repo-bot[bot]"
 <268009190+aspire-repo-bot[bot]@users.noreply.github.com>
Date: Thu, 13 Aug 2026 22:30:03 +0000
Subject: [PATCH] docs: describe automatic CLI bundle setup recovery at build
 time

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 src/frontend/src/content/docs/get-started/aspire-sdk.mdx | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/frontend/src/content/docs/get-started/aspire-sdk.mdx b/src/frontend/src/content/docs/get-started/aspire-sdk.mdx
index ad75e3510..80057ea39 100644
--- a/src/frontend/src/content/docs/get-started/aspire-sdk.mdx
+++ b/src/frontend/src/content/docs/get-started/aspire-sdk.mdx
@@ -117,7 +117,8 @@ When `AspireUseCliBundle` is `true`:
 - At build time, the SDK resolves the DCP and Dashboard executables in this priority order:
     1. Explicit `AspireCliBundlePath` / `AspireCliPath` properties in the project file.
     2. The `aspire` executable on `PATH`.
-- If the bundle cannot be found, the build emits error `ASPIRE009` with a message directing you to [get.aspire.dev](https://get.aspire.dev) to install the Aspire CLI.
+- If the resolved Aspire CLI has a bundle that hasn't been extracted yet, the build runs `aspire setup` through the selected `aspire` (or paired `dnx`) invocation to extract it, then resolves the bundle again. This recovers installations that didn't run the release install scripts, so an AppHost can build and launch directly from an IDE without first running an Aspire CLI command.
+- If the bundle still cannot be found or resolved after setup runs, the build emits error `ASPIRE009` with a message directing you to [get.aspire.dev](https://get.aspire.dev) to install the Aspire CLI.
 
 #### Enable the opt-in