Content for Aspire release 13.4#907
Draft
IEvangelist wants to merge 20 commits into
Draft
Conversation
* chore: Update integration data and GitHub stats (5/7/26) (#882) Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Use pnpm instead of npm in check-data-files.mjs (#881) The repository is configured as a pnpm workspace (pnpm-workspace.yaml, pnpm-lock.yaml, packageManager: pnpm@10.30.1), but check-data-files.mjs hardcoded `npm run update:all`. Running npm inside a pnpm workspace ignores pnpm-lock.yaml, creates an unnecessary package-lock.json, and can corrupt or destabilize the local development environment. Fixes #872 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * chore: Update integration data and GitHub stats (5/8/26) (#890) Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Add Hot Reload and watch guidance (#887) * Add Hot Reload and watch guidance Document Aspire watch behavior for AppHost changes, resource-specific restart and rebuild workflows, and IDE-managed hot reload/debugging boundaries. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Clarify dotnet watch AppHost behavior Document current dotnet watch behavior for Aspire AppHosts and .NET project resources, including restart behavior and known quirks requiring explicit restart or rebuild commands. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Clarify C# projects watch guidance Rename the project resources tab to C# projects and tighten the dotnet watch wording around C# project behavior. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Refine C# dotnet watch guidance Lead the C# projects section with dotnet watch support for C# AppHosts and move current experience quirks into an Important note. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Reduce C# watch guidance repetition Tighten the C# projects section so dotnet watch support and defaultWatchEnabled behavior are not repeated. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Update standalone dashboard docs for Aspire CLI (#886) * Update standalone dashboard docs Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Centralize standalone dashboard prerequisites Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Restore dashboard landing quick start Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Address dashboard quick start feedback Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Fix terminal tabs regression test source Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Fix standalone dashboard telemetry limits link Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Show both dashboard quick start options Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Address standalone dashboard review feedback Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: David Pine <david.pine@microsoft.com>
…source-commands (#892) * docs: add command arguments, validation, and visibility to custom-resource-commands Documents new features from microsoft/aspire#16710: - Command arguments (InteractionInput, InputType, InteractionInputCollection) - Typed argument accessors (GetString, GetBoolean, GetInt32, GetDouble in C#; toArray, value, requiredValue in TypeScript) - Positional CLI argument passing - Argument validation (ValidateArguments callback, field-level errors) - Command visibility (ResourceCommandVisibility.Dashboard, Api, All) Covers both C# and TypeScript AppHost usage. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * docs: fix ResourceCommandVisibility names and accessor return types Verified against microsoft/aspire source: - ResourceCommandVisibility values are None, UI, Api (bit-combinable); the previously documented names Dashboard and All do not exist. Use UI | Api for "both" (the default). - InteractionInputCollection.GetInt32/GetBoolean/GetDouble return non-nullable values and throw on absent or unparseable input; only GetString returns string?. Updated comments and prose. - Replaced "GetInt32(...) ?? 1" in the example, which would not compile against a non-nullable int return, with int.TryParse against GetString. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * docs: clarify custom command input property types Update the InteractionInput property table to reflect that Label is optional and that Choice options use the IReadOnlyList/InteractionInputOption shape from the product APIs. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: David Fowler <davidfowl@gmail.com>
Rename `withRoleAssignments` to `withFoundryRoleAssignments` in the TypeScript AppHost example following microsoft/aspire#16886 which uses integration-specific export names to avoid ATS SDK dump collisions. Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
The aspire exec command was removed in microsoft/aspire#16913. Remove the associated execCommandEnabled feature flag entry from the CLI configuration settings reference table. Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…ss displayImmediately overload (#897) Update the 'Auto-open the result dialog in the dashboard' C# example to use the new four-argument CommandResults.Success overload added in microsoft/aspire#16906, replacing the lower-level CommandResultData object-initializer pattern with the more ergonomic factory call. Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…902) * docs: document --yes required with --non-interactive for aspire update The aspire update command now validates that --yes is provided when --non-interactive is specified, matching the existing behavior of aspire destroy. Add a Non-interactive usage section to the update command docs to make this requirement explicit. Documents changes from microsoft/aspire#16829 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: David Fowler <davidfowl@gmail.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
…ion (#904) * docs: document resource-scoped command help and --include-hidden option Documents changes from microsoft/aspire#16921: - Add section explaining that 'aspire resource <resource> --help' shows available resource commands discovered from the running AppHost. - Document the '--include-hidden' option for showing and executing hidden resource commands. - Document the '--' delimiter for passing --help to resource commands. - Add AppHost selection section with clearer structure. - Add examples for listing available commands and using --include-hidden. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * docs: use apphost source files in resource examples Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: David Fowler <davidfowl@gmail.com>
…option (#888) * docs: document AI Agents dialog and DisableAgentHelp config option Documents the new AI Agents button added to the Aspire dashboard header in microsoft/aspire#16869, including: - New section in ai-coding-agents.mdx describing the header button and adaptive dialog content - New Dashboard:UI:DisableAgentHelp config entry in configuration.mdx Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Apply suggestion from @JamesNK --------- Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: James Newton-King <james@newtonking.com>
…mand-specific help (#898) * docs: update aspire resource command with named options and command-specific help Documents the new named option support for resource command inputs: - Named options (--option-name) instead of positional values - Command-specific --help output showing input types, defaults, and allowed values - Using -- separator to avoid option name collisions Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * docs: address aspire resource review feedback Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: David Fowler <davidfowl@gmail.com>
…signments guide (#896) * docs: document AzureRoleAssignmentResource for programmatic role assignment inspection Add a new section to the Azure role assignments guide documenting the AzureRoleAssignmentResource type introduced in microsoft/aspire#16888. The new section explains: - The three properties exposed by AzureRoleAssignmentResource (TargetAzureResource, OwnerResource, and IdentityResource) - How to enumerate role assignment resources from a pipeline step - The null semantics for global vs. targeted role assignments Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * PR feedback --------- Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: Eric Erhardt <eric.erhardt@microsoft.com>
* docs: add AspireUseCliBundle opt-in documentation Document the new AspireUseCliBundle MSBuild property introduced in microsoft/aspire#16811 that allows AppHost projects to source DCP and the Aspire Dashboard from the Aspire CLI bundle instead of platform- specific NuGet packages. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * docs: move CLI bundle opt-in to Aspire SDK page Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * docs: fix Aspire CLI bundle docs rendering Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Revert "[docs] Add AzureRoleAssignmentResource documentation to Azure role assignments guide (#896)" This reverts commit deed841. * docs: clarify CLI bundle dependency wording Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * docs: restore role assignments base content Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: David Fowler <davidfowl@gmail.com>
* Initial plan * feat: add skeleton What's New for Aspire 13.4 Agent-Logs-Url: https://github.com/microsoft/aspire.dev/sessions/9761e602-b5d7-47fe-a1e1-4639f2afd3d1 Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com> --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>
* docs: add WithProcessCommand / process-backed resource commands Documents the new experimental WithProcessCommand API introduced in microsoft/aspire#16923, which lets AppHost authors add custom commands backed by external processes. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * docs: address review feedback - add ASPIREPROCESSCOMMAND001 diagnostic article, update TS example, conceptualize config sections, vertical array formatting Agent-Logs-Url: https://github.com/microsoft/aspire.dev/sessions/91ac4d2c-f747-49d2-ade1-2220fd9c5d7b Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com> * docs: refine process command documentation Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * docs: use node in TypeScript process command sample Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com> Co-authored-by: David Fowler <davidfowl@gmail.com>
…cessCommandFactory) (#923) * Add docs for withProcessCommand and withProcessCommandFactory polyglot APIs Documents the TypeScript (polyglot) process-backed resource command APIs introduced in microsoft/aspire#16972: - withProcessCommand: static process spec registered at AppHost startup - withProcessCommandFactory: dynamic spec built from ExecuteCommandContext arguments at invocation time Adds fundamentals/process-commands.mdx and registers it in the sidebar between Custom HTTP commands and Custom resource URLs. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Consolidate process command docs Move the TypeScript process command factory example into the existing custom resource commands page and remove the duplicate standalone page/navigation entry. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: David Fowler <davidfowl@gmail.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.
Preview: aka.ms/aspire/vnext