Warn TS AppHost users to run aspire update --self first in 13.4 release notes#1067
Merged
Merged
Conversation
For TypeScript AppHost projects on Aspire 13.3.x, running `aspire update` before `aspire update --self` fails mid-flight with "No code generator found for language: TypeScript" because the 13.3.x CLI bundles an apphost server that cannot load the 13.4 TypeScript code generator. The failure leaves `aspire.config.json` pointing at 13.4 packages while the CLI is still 13.3.x, which breaks `aspire run` and `aspire restore` too. Add a caution `Aside` to the 13.4 "Upgrade to Aspire 13.4" section and strengthen the migration step list to call out that `aspire update --self` is required for TypeScript AppHost users on 13.3.x. Links to microsoft/aspire#17077 for background. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Contributor
There was a problem hiding this comment.
Pull request overview
Updates Aspire 13.4 “What’s new” documentation to prevent TypeScript AppHost users on 13.3.x from hitting a known broken upgrade sequence by emphasizing that the CLI must be self-updated before upgrading project packages.
Changes:
- Add a caution
<Aside>in the “Upgrade to Aspire 13.4” section specifically for TypeScript AppHost users, describing the failure mode and required command order. - Strengthen the “Migration from Aspire 13.3 to 13.4” step list to explicitly call out
aspire update --selfas required for TypeScript AppHosts (with a link to microsoft/aspire#17077).
Show a summary per file
| File | Description |
|---|---|
| src/frontend/src/content/docs/whats-new/aspire-13-4.mdx | Adds TypeScript-specific upgrade caution and clarifies the migration step ordering to avoid partially-upgraded states. |
Copilot's findings
Tip
Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
- Files reviewed: 1/1 changed files
- Comments generated: 2
| stable version. | ||
| </Aside> | ||
|
|
||
| <Aside type="caution" title="TypeScript AppHost users: run `aspire update --self` first"> |
| ❌ An unexpected error occurred: No code generator found for language: TypeScript | ||
| ``` | ||
|
|
||
| The 13.3.x CLI bundles an apphost server that cannot load the 13.4 TypeScript |
JamesNK
approved these changes
May 26, 2026
Member
JamesNK
left a comment
JamesNK
left a comment
There was a problem hiding this comment.
LGTM — content is accurate, MDX is well-formed, and the warning will save TS AppHost users real pain. Please address the two existing review comments before merging (backtick rendering in the Aside title, and "apphost" → "AppHost" capitalization).
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.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
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.
What
Adds a caution
Asideto the Upgrade to Aspire 13.4 section of the 13.4 "What's new" page, and strengthens the Migration from Aspire 13.3 to 13.4 step list, calling out that TypeScript AppHost users on 13.3.x must runaspire update --selfbeforeaspire update.Why
For TypeScript AppHost projects on Aspire 13.3.x, running
aspire updatebeforeaspire update --selffails mid-flight with:The 13.3.x CLI bundles an apphost server that cannot load the 13.4
Aspire.Hosting.CodeGeneration.TypeScriptassembly (new types inAspire.TypeSystemcauseReflectionTypeLoadExceptionduring code-generator discovery). Package restore succeeds,aspire.config.jsonis rewritten to point at 13.4, then TypeScript SDK regeneration crashes — leaving the project in a partially-upgraded, unrunnable state whereaspire runandaspire restorealso fail untilaspire update --selfis run.Tracking issue: microsoft/aspire#17077. The CLI-side fix (microsoft/aspire#17100) is in
mainand will ship with 13.4, but was not backported to release/13.3, so 13.3.x stable users will hit this until they update the CLI.Repro (verified today against
13.3.5stable +13.4.0-preview.1.26275.2daily)13.3.5).aspire new aspire-ts-starter.aspire update --channel daily(stable CLI) → fails with the error above;aspire.config.jsonSDK version is bumped to13.4.0-preview.1.26275.2while CLI is still13.3.5; subsequentaspire runalso fails.Workaround in the new
Aside: runaspire update --selffirst.Diff
Asideimmediately above the upgrade<Steps>block.--selfis required for TypeScript AppHosts on 13.3.x, with a link toaspire updatefor TypeScript AppHost fails with "No code generator found for language: TypeScript" when CLI is older than target package version; leaves project in broken state aspire#17077.