🤓 Content for release: 13.5#1233
Draft
IEvangelist wants to merge 57 commits into
Draft
Conversation
…1181) * docs: document timestamp search qualifier for telemetry filtering Documents the new 'timestamp' search qualifier added in microsoft/aspire#17816. Users can now filter traces and structured logs by date/time using ISO 8601 strings with comparison operators (>, >=, <, <=) in the dashboard filter bar. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Move timestamp qualifier docs to shared CLI references Co-authored-by: JamesNK <303201+JamesNK@users.noreply.github.com> * Fix severity casing in timestamp search example Co-authored-by: JamesNK <303201+JamesNK@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: James Newton-King <james@newtonking.com> * Apply suggestion from @JamesNK * Apply suggestion from @JamesNK * docs: clarify date-only timestamp search values Co-authored-by: JamesNK <303201+JamesNK@users.noreply.github.com> * Apply suggestion from @JamesNK * Apply suggestion from @JamesNK * Update timestamp example dates to use 2026 --------- 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: JamesNK <303201+JamesNK@users.noreply.github.com> Co-authored-by: James Newton-King <james@newtonking.com>
* Fix persistent container endpoint proxy default docs Persistent containers use proxied endpoints by default (same as session containers), while persistent executables and projects default to proxyless endpoints. Also document that proxyless container endpoints with only a targetPort immediately allocate the targetPort as the host port. Corrects docs that previously stated all persistent resources default to proxyless endpoints. Documents changes from microsoft/aspire#17960. 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 Negstad <50252651+danegsta@users.noreply.github.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…re#17889) (#1210) * docs: update Foundry Local section to reflect CLI-based lifecycle The Foundry Local integration now uses the installed 'foundry' CLI (foundry service start/stop/list and foundry model download/load) instead of the FoundryLocalManager in-proc APIs. Aspire manages the entire service lifecycle automatically. Update docs to: - Clarify users do not need to pre-start Foundry Local - State that the 'foundry' CLI must be on PATH - Describe the automatic start/stop lifecycle management 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: Sébastien Ros <sebastienros@gmail.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Contributor
There was a problem hiding this comment.
Pull request overview
Adds Aspire 13.5 “What’s new” placeholder content and updates several docs to reflect recent networking/persistence behavior changes and new CLI telemetry search capabilities (timestamp filtering).
Changes:
- Add placeholder release notes page for Aspire 13.5 and wire it into the docs sidebar.
- Update persistent lifetime/proxyless endpoint guidance across “What’s new”, networking fundamentals, and resource lifetime docs.
- Extend CLI
--searchdocumentation to include timestamp comparisons for logs/traces/spans (plus command reference updates).
Reviewed changes
Copilot reviewed 10 out of 10 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
| src/frontend/src/content/docs/whats-new/aspire-13-5.mdx | Adds placeholder Aspire 13.5 release notes + upgrade/install guidance scaffolding. |
| src/frontend/src/content/docs/whats-new/aspire-13-4.mdx | Clarifies persistent proxy behavior differences between containers vs executables/projects. |
| src/frontend/src/content/docs/reference/cli/search-filter.mdx | Documents timestamp qualifier and comparison behavior for --search. |
| src/frontend/src/content/docs/reference/cli/commands/aspire-otel-traces.mdx | Updates supported search fields + adds timestamp filtering example. |
| src/frontend/src/content/docs/reference/cli/commands/aspire-otel-spans.mdx | Updates supported search fields + adds timestamp filtering example. |
| src/frontend/src/content/docs/reference/cli/commands/aspire-otel-logs.mdx | Updates supported search fields + adds timestamp filtering example. |
| src/frontend/src/content/docs/integrations/cloud/azure/azure-ai-foundry/azure-ai-foundry-host.mdx | Updates Foundry Local lifecycle explanation and prerequisites around foundry CLI. |
| src/frontend/src/content/docs/fundamentals/networking-overview.mdx | Refines proxyless endpoint defaults/behavior for persistent resources and containers. |
| src/frontend/src/content/docs/app-host/resource-lifetimes.mdx | Updates persistent lifetime endpoint proxy defaults and proxyless container endpoint note. |
| src/frontend/config/sidebar/docs.topics.ts | Adds “Aspire 13.5” entry to the “What’s new” sidebar section. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
|
|
||
| The supported comparison operators are `>`, `>=`, `<`, and `<=`. | ||
|
|
||
| Timestamp values are internally stored with UTC. The `timestamp` value is converted to UTC using these timezone rules: |
Contributor
Frontend HTML artifact readyThe latest frontend build uploaded the This comment updates automatically when a new frontend build artifact is uploaded. |
Add a new row to the CLI telemetry data points table for Aspire CLI 13.5 documenting the new coding agent detection telemetry. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…8065-a0f9d35c8766b2f3 [docs] Document coding agent telemetry detection in CLI telemetry page
* docs: add WithTerminal() interactive terminal sessions page Documents the WithTerminal() experimental API introduced in Aspire 13.5: - Basic usage (C# and TypeScript) - Custom terminal dimensions - Multi-replica support - Dashboard terminal view - aspire terminal attach / aspire terminal ps CLI commands Closes microsoft/aspire#17866 (docs obligation) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * docs: address PR review feedback for withterminal docs - remove redundant sidebar translations block - clean up unused import and wording updates - fix CLI reference link target - remove duplicate build/run call in dimensions sample Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Mitch Denny <midenn@orangecake.local> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Update all banners (18 files across English and 16 locale variants) from 13.4 to 13.5 with engaging messaging - Replace 13.5 placeholder release notes with comprehensive content from the official changelog - Include detailed release highlights covering AppHost, CLI, Dashboard, and Extensions improvements - Document breaking changes (ServiceProvider renamed, PublishAsConnectionString obsolete, aspire ps --resources flag removed) - Maintain consistent tone and voice with prior What's new articles Changes cover: - Interactive terminal sessions with WithTerminal() - Polyglot IInteractionService across TypeScript, Python, Go, Java, Rust - User-defined resource command arguments - TypeScript AppHost stability fixes and optimizations - Custom health checks for TypeScript AppHosts - CLI enhancements (npm package, embedded skills bundle) - Dashboard telemetry improvements (timestamp filtering, better error messages) - VS Code extension enhancements (Dashboard side panel, Bun debugging, resource commands) - Foundry Local integration CLI updates - And more bug fixes and improvements Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Add documentation for the new operating system check introduced in microsoft/aspire#18252. The check appears in the Environment section of `aspire doctor` output and includes structured metadata in JSON format. Changes: - Update Environment checks description to mention OS reporting - Add OS check to sample table output - Add operating-system entry to JSON output example - Document the osType/displayName/version/description metadata fields Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* docs: clarify C# file-based AppHost launch profile location The empty C# AppHost template (created with `aspire new`) stores launch profiles in `apphost.run.json`, not in `aspire.config.json`. The `aspire.config.json` for this template only contains the `appHost.path` reference pointing at `apphost.cs`. Update the AppHost configuration page to distinguish between: - Project-based AppHosts: profiles in `Properties/launchSettings.json` - File-based AppHosts: profiles in `apphost.run.json`, with `aspire.config.json` holding only the entry-point reference This aligns the documentation with the fix in microsoft/aspire#17781, which corrected a regression where the file-based template was incorrectly emitting a duplicate `profiles` block in `aspire.config.json`. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Apply suggestions from code review 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 Pine <david.pine@microsoft.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
* docs: document icon fallback behavior for resource commands When a resource command specifies an unrecognized iconName, the dashboard now renders a QuestionCircle (question mark circle) icon as a fallback instead of displaying the raw display-name text. For highlighted commands (IsHighlighted = true) with no iconName, the dashboard uses a Flash icon by default so the inline action button stays compact and never overflows the resource row. Documents changes from microsoft/aspire#18389. 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>
* docs: Add Nix installation path for Aspire CLI Documents the first-party Nix flake for the Aspire CLI introduced in microsoft/aspire#18410: - Adds a 'Nix' tab to the Install CLI package manager section, with nix run, nix profile add, and flake.nix usage examples - Updates the 'aspire update --self' section to describe how Nix installs print profile/flake update guidance instead of a binary download Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * docs: address Nix CLI review comments Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * docs: fix Nix flake CLI example 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>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
…830cd8abec29e2f [docs] Add OS information check to aspire doctor docs
…1199) * docs: document proxyless container endpoint on-demand allocation Documents the on-demand port allocation behavior for dynamic proxyless container endpoints introduced in Aspire 13.5 (microsoft/aspire#17851). Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * docs: update proxyless endpoint port allocation Co-authored-by: danegsta <50252651+danegsta@users.noreply.github.com> * docs: align proxyless port allocation docs Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * docs: clarify proxyless container port wording Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * docs: remove redundant proxyless port text Co-authored-by: Copilot App <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: danegsta <50252651+danegsta@users.noreply.github.com> Co-authored-by: David Negstad <David.Negstad@microsoft.com>
* Add Aspire version placeholders to release docs Co-authored-by: Copilot App <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> * Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+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> * Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+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> * Remove generated Nix icon safelist entry Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Document release version placeholder checks Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Document current version placeholder review guidance Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Use version placeholder in seed database packages Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
IEvangelist
requested review from
JamesNK,
aaronpowell,
davidfowl and
maddymontaquila
as code owners
* Fix OOM in aspire-version-placeholders build hook The astro:build:done hook re-walked the entire dist tree with a single recursive Promise.all, holding the contents of every .html/.md/.txt file (tens of thousands across all locales, including the large llms-full.txt assets) in memory at once. On the full production build that exhausted the default ~4 GB Node heap and crashed with 'JavaScript heap out of memory'. That broad walk was almost entirely redundant. The remarkAspireVersionPlaceholders remark plugin is already wired into markdown.remarkPlugins, so placeholders are replaced before render: .html pages are correct, and llms*.txt is sourced from rendered HTML via render(entry). The reference/**/*.md endpoints come from API/sample data, not docs content. The only generated artifact that still contains raw placeholders is the per-page .md copies emitted by starlight-page-actions, which viteStaticCopy's raw src/content/docs/** through a regex-only transform that bypasses the remark pipeline. Scope the post-build pass to .md files only and stream them through a bounded worker pool (default concurrency 16). Peak memory is now proportional to the concurrency limit, and the bulk of dist (.html plus the large .txt assets) is no longer re-read. Replacement semantics are unchanged. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> * Address PR review: normalize concurrency and clarify test comment - Guard against a non-finite/0/negative concurrency value: normalize to a finite positive integer (falling back to the default) before computing the worker count, so a stray NaN can't collapse the pool to an empty array and silently skip every file. Adds a regression test passing NaN. - Reword the scoping test comment so it no longer implies the seeded .html/.txt/.mdx fixtures were already replaced; clarify the assertion is that this pass intentionally leaves every non-.md extension untouched. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: David Pine <7679720+IEvangelist@users.noreply.github.com> 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.
Uh oh!
There was an error while loading. Please reload this page.