Regenerate API data from Aspire 13.6.0 staging build f4c27f2d - #1787
Merged
David Pine (IEvangelist) merged 3 commits intoSep 29, 2026
Merged
David Pine (IEvangelist) merged 3 commits into
David Pine (IEvangelist) merged 3 commits into
Conversation
Contributor
Frontend HTML artifact readyThe latest frontend build uploaded the This comment updates automatically when a new frontend build artifact is uploaded. |
Regenerate the integration catalog, C# package API JSON, TypeScript API modules, and Twoslash types from the darc-pub-microsoft-aspire-f4c27f2d staging feed (microsoft/aspire release/13.6 f4c27f2d, Aspire 13.6.0 and 13.6.0-preview.1.26478.8) with a locally fixed ATS scanner. Fix the package JSON generator so Provisioning overlays restore the resolved Aspire.Hosting version instead of their own prerelease version. Correct the Blazor gateway diagnostic aside, and describe the backtick shortcut as the way to open the dashboard terminal dock now that its navigation entry points are removed (microsoft/aspire#20562). Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
David Pine (IEvangelist)
force-pushed
the
ievangelist-13-6-documentation-coverage
branch
from
September 29, 2026 04:27
399d998 to
2e9fa1d
Compare
David Pine (IEvangelist)
changed the title
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
David Pine (IEvangelist)
marked this pull request as ready for review
September 29, 2026 13:55
David Pine (IEvangelist)
requested a review
from Eric Erhardt (eerhardt)
as a code owner
September 29, 2026 13:55
David Pine (IEvangelist)
enabled auto-merge (squash)
September 29, 2026 13:55
Copilot started reviewing on behalf of
David Pine (IEvangelist)
September 29, 2026 13:56
View session
Contributor
There was a problem hiding this comment.
Copilot review overview
🟡 Changes recommended
Selective generation can restore provisioning overlays against the feed’s latest Hosting version instead of the catalog-pinned version.
Review effort: Balanced
Findings: 1
Open (1)
What changed in this PR
Refreshes Aspire 13.6 API reference data from staging build f4c27f2d and aligns related documentation.
Changes:
- Regenerates C#, TypeScript, and Twoslash API data, including six
WithReplAPIs. - Updates Blazor diagnostic and dashboard terminal documentation.
- Adjusts provisioning-overlay restore handling.
| File | Description |
|---|---|
src/tools/PackageJsonGenerator/generate-package-json.ps1 |
Resolves a separate Hosting version for provisioning overlays. |
src/frontend/src/data/aspire-integrations.json |
Refreshes package versions and download counts. |
src/frontend/src/data/pkgs/*.json (127 files) |
Refreshes C# API metadata and provenance. |
src/frontend/src/data/ts-modules/*.json (87 files) |
Refreshes TypeScript API metadata and exports. |
src/frontend/src/data/twoslash/aspire.d.ts |
Updates consolidated TypeScript declarations. |
src/frontend/src/content/docs/integrations/dotnet/blazor-hosting.mdx |
Corrects experimental diagnostic guidance. |
src/frontend/src/content/docs/whats-new/aspire-13-6.mdx |
Updates terminal dock navigation guidance. |
💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
David Pine (IEvangelist)
added a commit
that referenced
this pull request
Sep 29, 2026
… its types Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
…ng overlay restores Addresses review feedback: use the catalog's Aspire.Hosting version before falling back to the latest feed version. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
David Pine (IEvangelist)
deleted the
ievangelist-13-6-documentation-coverage
branch
September 29, 2026 15:03
David Pine (IEvangelist)
added a commit
that referenced
this pull request
Sep 29, 2026
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
David Pine (IEvangelist)
added a commit
that referenced
this pull request
Sep 29, 2026
Completes the in-progress `aspire-13-6.mdx` draft by adding the remaining "Ship Mode" / changelog highlights, without removing any previously approved content. ## What's added - **Dashboard:** Native AOT standalone dashboard + Fluent UI Blazor v5 refresh. - **Integrations:** docked database/cache REPLs (`WithRepl()`), remote Foundry Local services (`RunAsFoundryLocal(endpoint)`), Cosmos DB emulator OpenTelemetry. - **App model:** multithreaded coordinated builds, Project V2 migration skill for agents. - **CLI:** pin the CLI via a local tool manifest (`AspireCliInvocationMode`), MCP config now opt-in in `aspire new`/`init`. - **VS Code:** outdated-CLI warning. - Reworked the "This release introduces" list into a high-level summary rather than a section-by-section table of contents. ## Update: TODOs and review feedback addressed - **Merged `release/13.6`** (42 commits, including #1780 and #1684). When resolving conflicts, I kept this PR's summary list and emoji headings and took the release branch's corrected facts: .NET project graduation, `-mt` SDK requirements, and the Blazor gateway publish support. I kept the Project V2 migration skill and Remote Foundry Local bullets. - **All TODOs resolved; the article now has none:** - Connector Namespace (#1781): links to `/integrations/cloud/azure/azure-connector-namespace/`. - Connection-string naming (#1782): links to `/fundamentals/environment-variables/#migrating-connection-string-consumers`. - Foundry Toolbox (#1628): links to the Toolbox walkthrough. - Docked REPLs (#1777): links to the per-integration **Open an interactive REPL** sections. The six REPL anchors were broken (`#add-*-with-a-repl-command`) and are fixed to `#open-an-interactive-repl`. - Java (@marshalhayes): added an `addSpringBootApp` / `AddSpringBootApp` sample, taken from the package README. - Rust (@afscrome): used the reviewer's `addRustApp(...).withHttpEndpoint({ env: 'PORT' })` sample. - **Twoslash:** every TypeScript AppHost fence is now `twoslash`. New TypeScript-first tabs cover `withRepl`, `withTerminal`, `addRustApp`, `addSpringBootApp`, `withBuildEnvironment`, `addDenoApp`, and `addToolbox`. - **Preview note:** added a "Prerelease packages" note. Java, Rust, Connector Namespace, and Sandboxes ship as `13.6.0-preview.1`. - **Deno bullet:** now accurately says `AddDenoApp` is experimental (`ASPIREDENO001`) and distinct from the Community Toolkit Deno integration. - **API vetting:** all 45 API names in the article are verified against microsoft/aspire `release/13.6` @ `f4c27f2d`. `WithRepl` comes from microsoft/aspire#20419 and exists on Redis, Valkey, PostgreSQL, MySQL, SQL Server, and MongoDB. **Validation** was run against this branch plus the #1787 13.6.0 API data: - `twoslash-blocks` passes. A negative control (`withReplz`, `addSpringBootAppz`) fails with TS2551 as expected. - 59 API-reference and SEO tests pass. - All internal links and anchors in the article resolve. > [!IMPORTANT] > Merge #1787 first. The new Twoslash blocks need its regenerated 13.6.0 types (`withRepl`, Java, Rust). --------- Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Co-authored-by: David Pine <7679720+IEvangelist@users.noreply.github.com> Copilot-Session: 829e510d-2b06-4301-9759-3bd760c45e5c
David Pine (IEvangelist)
added a commit
that referenced
this pull request
Sep 29, 2026
## Summary <!-- Describe what this pull request changes and why. --> Onboards the first-party Java (`Aspire.Hosting.Java`) and Rust (`Aspire.Hosting.Rust`) hosting integrations that ship in Aspire 13.6. The Community Toolkit–based articles are replaced by the official three-article integration format that other official integrations use: | Integration | Get started | Set up in the AppHost | Connect | | --- | --- | --- | --- | | Java | `java-get-started` (rewritten) | `java-host` (rewritten) | `java-connect` (new) | | Rust | `rust-get-started` (rewritten) | `rust-host` (rewritten) | `rust-connect` (new) | - **Get started:** why to use the integration, prerequisites, an architecture diagram, and steps that lead to the other two articles. - **Set up … apps in the AppHost:** - Installation. - Java: Spring Boot, Quarkus, and Java apps (a Maven or Gradle task, or a prebuilt JAR), builds, JVM options, the OpenTelemetry Java agent, and Java containers. - Rust: Cargo and program arguments, binary selection, and environment variables. - Certificate trust, debugging, and publishing, including generated Dockerfiles. - A concise **Migrate from the Community Toolkit** section. Rust keeps the Toolkit-only Bacon note. - **Connect to … apps:** - The connection properties that consumers receive. - Connecting from the AppHost and from apps in other languages. - How the Java or Rust app reads what Aspire injects: its port, references, connection strings, OTLP telemetry settings, and development-certificate trust. - Every API mention uses the new `<ApiReference />` component. Every TypeScript AppHost sample is `twoslash`-checked, and the TypeScript tab comes first. - Adds **Connect to Java apps** and **Connect to Rust apps** to the integrations sidebar. - Updates the Java pivot of the AppHost overview (`get-started/app-host`) to use `Aspire.Hosting.Java` and `AddSpringBootApp`. The `ja` copy is updated too, because it shares the `SimpleAppHostCode` sample and its highlight ranges moved. - A separate commit changes "App Host" to "AppHost" in the EF Core architecture diagram. Facts were verified against the microsoft/aspire `release/13.6` sources, READMEs, and playgrounds. The migration mappings were verified against the Community Toolkit v13.5.0 APIs. Notes for reviewers: - The 📦 `Aspire.Hosting.Java` and `Aspire.Hosting.Rust` NuGet links resolve once 13.6 ships. - This branch is rebased on #1787, which regenerated the API data from the 13.6.0 staging build. The `twoslash` and `ApiReference` tests pass against the regenerated data. ## Third-party links and affiliations <!-- List any third-party links added or changed by this pull request and disclose any material affiliation with the linked organizations, such as employment, sponsorship, or ownership. Write "None" if this pull request doesn't add or change third-party links. --> This PR adds links to project documentation: - **Java:** dev.java, spring.io, docs.spring.io, quarkus.io, maven.apache.org, gradle.org, and docs.gradle.org. - **Rust:** rust-lang.org, doc.rust-lang.org, docs.rs (`axum`, `opentelemetry-otlp`, `reqwest`, and `sqlx`), and opentelemetry.io. - **Microsoft:** nuget.org (`CommunityToolkit.Aspire.Hosting.Rust`) and the Rust playground in github.com/microsoft/aspire. The author is a Microsoft employee. There is no material affiliation with the other linked organizations. ## Validation <!-- List the checks you ran or explain why validation isn't needed. --> - `pnpm test:unit` (after rebasing on #1787): 977 passed and 1 skipped. This includes the `twoslash-blocks`, `api-reference`, SEO-length, redirect, and Dev Hub catalog tests. - `pnpm build:skip-search`, the production build without the Pagefind index, completed before the rebase. `starlight-links-validator` reported: "All internal links are valid." - ESLint on the changed TypeScript files, the forbidden-words rules on all added lines, and `git diff --check`. - Every internal link and anchor resolves: 126 outbound links from the changed pages and 51 inbound links to the Java and Rust pages. External URLs were checked too. - The Rust samples compile with `cargo check`, using `opentelemetry-otlp` 0.33. - All six pages were checked visually on the dev server, including the diagrams, `ApiReference` labels, and tab sync. - Two independent accuracy reviews against the 13.6 sources. All of their findings were applied. --------- Co-authored-by: Copilot App <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.
Follow-up to #1780, which merged with two open checkboxes. Both are now validated against the latest staging build.
This is a single commit on top of the current
release/13.6tip (5589ce6d), so it merges cleanly.WithRepladditions and removed attributes.Provenance
darc-pub-microsoft-aspire-f4c27f2d(https://pkgs.dev.azure.com/dnceng/public/_packaging/darc-pub-microsoft-aspire-f4c27f2d/nuget/v3/index.json).release/13.6atf4c27f2d43ddc1cacd0dd083b30d1fea1cee7a62, the newest staging build. Every regenerated official TS module recordssourceCommit: f4c27f2d…, and the restored nuspecs (for example Redis, Blazor and CodeGeneration.TypeScript) report that commit.13.6.0; prerelease packages are13.6.0-preview.1.26478.8. The codegen package isAspire.Hosting.CodeGeneration.TypeScript 13.6.0, mapped exclusively to the staging feed. nuget.org has no13.6.0, so resolution is unambiguous.a11eca96plus320eed42(the Fix duplicate inherited ATS method exports aspire#20438 content) and435fd4eb(the [release/13.6] Fix duplicate inherited ATS method exports aspire#20443 content). Both upstream PRs are still unmerged.a11eca96..f4c27f2dtouchesAtsCapabilityScanner,Aspire.TypeSystemorAspire.Hosting.CodeGeneration.TypeScript. The last two commits ([release/13.6] Address container supply-chain warnings to make the official build green aspire#20566 and [release/13.6] Remove dashboard terminal navigation entry points aspire#20562) only change dashboard layout code and Dockerfiles.dashboardanddcpfolders are copies from the8230626cstaging CLI bundle. Layout discovery requires them, but they aren't used for scanning or code generation.NUGET_PACKAGES, HTTP cache,TEMPandASPIRE_HOMEfolders. That rules out reusinge8fd6fbbbits.ASPIRE_REPO_ROOTandASPIRE_REPO_PATHwere unset, and there was no source-project substitution.update:integrations→generate-package-json.ps1→normalize:api-data -- --pkgs→update:ts-api(with Twoslash.d.ts) →validate:api-data.d.tswere not hand-edited, and nothing from 14.x was imported.Deviation: no
ASPIRE_RELEASE_VERSIONpinPinning
13.6.0left the 50 prerelease packages stale. The feed is commit-specific, so the unpinned run resolves every package from the same build.Packages absent from the feed
These seven official packages aren't in this build, so they are carried forward unchanged:
Aspire.Elastic.Clients.Elasticsearch13.3.0Aspire.Hosting.AgentFramework.DevUI1.22.0-preview.260918.1Aspire.Hosting.AWS13.7.2Aspire.Hosting.ClickHouse13.5.3Aspire.Hosting.DocumentDB0.116.0Aspire.Hosting.Elasticsearch13.3.0Aspire.Hosting.GitHub.Models13.5.4Changes
aspire-integrations.json(still 217 packages; 82 at13.6.0and 50 at13.6.0-preview.1.26478.8),pkgs/(210 succeeded, 0 failed),ts-modules/(146 succeeded, 0 failed) andtwoslash/aspire.d.ts.integration-docs.jsonneeded no change.generate-package-json.ps1): the 24 Provisioning overlays restoredAspire.Hostingat the overlay's own prerelease version, which doesn't exist now thatAspire.Hostingis stable13.6.0. The script now uses the resolvedAspire.Hostingversion, via a new-HostingVersionparameter with a feed-lookup fallback for selective runs.AddDotnetProjectBlazorGatewayandWithBlazorClientAppreport their ownASPIREDOTNETPROJECT001diagnostic.ASPIREBLAZOR001applies to other experimental Blazor hosting types, such asBlazorWasmAppResource.ASPIREDOTNETPROJECT001, on exactly those two methods.dashboard/explore.mdxand the What's new bullet now describe the backtick key as the way to open and hide the terminal dock.Validation
WithReplcoverage: present in the C# and TS API data for all six REPL packages (PostgreSQL, MySql, MongoDB, SqlServer, Redis, Valkey) and inaspire.d.ts.f4c27f2dfeed (16 at13.6.0, 9 at26478.8). This covers REPL×6, Rust, ConnectorNamespace, Foundry Toolbox, Radius, CSI, Helm, Blazor (now matching [docs] Document DotnetProjectResource-backed Blazor gateway APIs for polyglot AppHosts #1564'sWithExternalHttpEndpointssample), Provisioning and Dotnet. The Dotnet samples need noASPIREDOTNETPROJECT001suppression.aspire restore(codegen13.6.0,Aspire.Hosting.Redis/13.6.0andAspire.Hosting.Blazor/13.6.0-preview.1.26478.8, all atf4c27f2d). Stricttsc(NodeNext) passes for all 18.mtssamples, including the new Blazor gateway TS sample. A negative control (withReplz) fails with TS2551.withContainerImagecollision onCSharpAppResourceis gone.createRoleAssignmentoverload collisions remain in 16 Provisioning overlays. They are recorded here, not suppressed; no doc sample calls this method.pnpm validate:api-datapasses (217 identities, 146 modules matched to C# provenance). These suites pass:test:unit:structured-data(82),api-reference(55),api-markdown(30),ts-api(31),twoslash-types(12),twoslash-blocks(2),llms-txt(12) anddocs(2).pnpm buildwas run; CI covers it.Not done
update:release-contributorsneeds thev13.6.0tag, which doesn't exist yet. This is left for after the release is tagged.