Repository navigation
Add verified Aspire 17.0 highlights without changing curated sections - #2166
Mitch Denny (mitchdenny) merged 7 commits into
Conversation
Preserve all existing curated sections and add source-pinned release highlights. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Mitch Denny (mitchdenny)
left a comment
There was a problem hiding this comment.
Validation of draft additions at head 30e1484, targeting release/17.0. Source: microsoft/aspire release/17.0 a509f094e0ee87d17dc0e1cc9bca84f7ca2623da, published baseline v13.6.5 b33d222049f1ecc3bc7257ec07b622fe550b2580. Phase A: 36 product claims verified, 0 contradicted, 0 unverifiable. Phase B: six sections tested, no demonstrated critical issues, five initial warning groups; polish follow-through and execution limits are recorded below. This is a COMMENT, not approval or release sign-off. Protected original content is outside the factual-review scope.
Aspire 17.0 critique and validation
Critique
Major, release-finalization: Research is a bounded draft, not an exhaustive account of 573 commits. Default image updates, matching-release resource artwork, diagnostics, terminal/tray/agent features, and complete contributor enumeration remain unfinished. No release-complete claim.
Major, protected content: Original lede has no 1:1 section summary; publishDate and resourceImage are absent; the original image section does not list the additional product-source tag changes. Preserve rather than fix. Eric's breaking-change summary and subsections remain byte-for-byte unchanged.
Major, teaching follow-through: The first draft linked to an older .NET hosting guide with obsolete publishing limitations and emulator guides without new-feature instructions. Polish replaced these destinations with exact-release source migration/README links, retaining their pinned SHA. Source-blind report remains frozen separately.
Minor, CLI setup: Specify current-shell lifetime for completion and AppHost directory for secret commands. Applied.
Minor, link clarity: Name Entra's external destination as the README on GitHub. Applied.
| Standard | Result |
|---|---|
| Separate deployment and integrations | Pass |
| Separate first-party new integrations | Pass |
| No independently released Toolkit features | Pass |
| Accurate positive, impact-first framing | Pass for additions |
| Judicious alerts | Pass: no new alerts |
| AppHost sample language parity | N/A: no new AppHost code fences |
| Section-summary 1:1 mapping | Not satisfied in protected introduction; unchanged |
| Full container-image inventory in article | Not satisfied in protected image section; dossier records source diff |
| Release date | Unavailable: v17.0.0 release endpoint 404 |
| Resource artwork | Not satisfied; no generic/17.1 artwork substituted |
| Community attribution | Included for authored community features; exhaustive release audit pending |
| Placeholder/TODO cleanup | Pass in additions |
| Diagnostic-author follow-up | Deferred: no diagnostic articles added |
Frozen Phase A: claim verification
Product source: microsoft/aspire release/17.0 SHA a509f094e0ee87d17dc0e1cc9bca84f7ca2623da.
Published comparison: v13.6.5 SHA b33d222049f1ecc3bc7257ec07b622fe550b2580.
No fallback to main, 17.1 daily, Community Toolkit, or Azure SDK main.
The following 36 product claims were individually checked against the pinned source. Verdicts: 36 verified, 0 contradicted, 0 unverifiable. Narrative statements and contributor attribution are not included in this product-claim denominator.
| ID | Normalized claim | Pinned evidence |
|---|---|---|
| A01 | Shared resource pane persists context across telemetry tabs | src/Aspire.Dashboard/Components/Layout/ResourcesLayout.razor.cs:866,1094-1106 |
| A02 | Pane supports search/filter/multiple selection | ResourcesLayout.razor, selection bindings and filter controls |
| A03 | Grouping by tags/resource type/state | ResourcesLayout.razor.cs:1361-1430 |
| A04 | Metrics display cards with live sparklines | src/Aspire.Dashboard/Components/Pages/Metrics.razor:214-271 |
| A05 | Instruments can be pinned | Metrics.razor.cs:326-333,379-384 |
| A06 | Previous experience is conditional and selectable in Settings | Components/Dialogs/SettingsDialog.razor.cs:110-122, Components/DashboardExperienceComponents.cs:25 |
| A07 | CLI exposes completions script subcommand | src/Aspire.Cli/Commands/CompletionsCommand.cs:14-36 |
| A08 | Accepted explicit shells are bash/fish/pwsh/zsh | src/Aspire.Cli/Completions/CompletionScripts.cs, SupportedShells |
| A09 | Completion script is written to stdout for redirection | CompletionsCommand.cs:44-57; exact pinned CLI execution succeeded |
| A10 | Secret commands support environment and -e | src/Aspire.Cli/Commands/SecretCommand.cs:16-29 |
| A11 | Omitted value opens secret input prompt | src/Aspire.Cli/Commands/SecretSetCommand.cs:96-98 |
| A12 | --envvar reads a named environment variable | SecretSetCommand.cs:26-31,81-92 |
| A13 | Noninteractive requires value or environment source | SecretSetCommand.cs:57-60 |
| A14 | Aspire minimum supported .NET is 10 | eng/Versions.props:11-12, diff from 13.6.5; PR #20614 |
| A15 | Requirement does not mandate .NET 10 for all orchestrated workloads | Separate Go/JavaScript workload hosting remains available; #20614 targets Aspire framework support |
| A16 | Dotnet hosting package now uses stable versioning | src/Aspire.Hosting.Dotnet/Aspire.Hosting.Dotnet.csproj:8-10, SuppressFinalPackageVersion removed vs 13.6.5 |
| A17 | AddProject is deprecated, retained | src/Aspire.Hosting/ProjectResourceBuilderExtensions.cs:71,110,125,383 |
| A18 | Entra hosting integration is new compared with baseline | New src/Aspire.Hosting.Azure.EntraId/Aspire.Hosting.Azure.EntraId.csproj |
| A19 | Entra package remains preview | Same csproj:8, SuppressFinalPackageVersion=true |
| A20 | Entra can provision registrations/service principals | EntraIdResourceExtensions.cs:59, provisioning code and pinned README |
| A21 | Existing Entra registrations can be referenced | EntraIdResourceExtensions.cs:371,433 |
| A22 | Entra references supply identity configuration | EntraIdResourceExtensions.cs:54-56, reference callbacks |
| A23 | Referencing Entra does not install authentication middleware | EntraIdResourceExtensions.cs:56, README authentication guidance |
| A24 | APIM hosting package is new and preview | New csproj, SuppressFinalPackageVersion=true |
| A25 | APIM models APIs/backends/policies | src/Aspire.Hosting.Azure.ApiManagement/AzureApiManagementExtensions.cs:180 and AddBackend/policy APIs |
| A26 | OpenAPI can come from file or reachable deployed endpoint | Same extensions, WithOpenApiDocument/WithOpenApiEndpoint; ordering at :78-106 |
| A27 | APIM is not provisioned in local run | Same extensions:109-112, CreateResourceBuilder rather than AddResource/provisioning |
| A28 | Kubernetes hosting packages stable | csproj SuppressFinalPackageVersion removed, PR #20936 |
| A29 | Some persistent-volume APIs remain experimental | KubernetesPersistentVolumeExtensions.cs and AzureKubernetesPersistentVolumeExtensions.cs Experimental(ASPIRECOMPUTE002) |
| A30 | Helm minimum is 4.0.0 | src/Aspire.Hosting.Kubernetes/Deployment/HelmVersionValidator.cs, MinimumHelmVersion |
| A31 | Existing AKS environments can be targeted | src/Aspire.Hosting.Azure.Kubernetes/AzureKubernetesEnvironmentExtensions.cs:128-149,896-1003 |
| A32 | Front Door Private Link supports provisioned ACA and App Service | src/Aspire.Hosting.Azure.FrontDoor/AzureFrontDoorPrivateLinkExtensions.cs:90-114 |
| A33 | Front Door Private Link API remains experimental | Same file:131-132 |
| A34 | Private endpoint must be approved before traffic flows | Same file:98-100 |
| A35 | Web PubSub supports local RunAsEmulator; Service Bus supports SQL resource reuse | AzureWebPubSubExtensions.cs:180, AzureServiceBusExtensions.cs:708 |
| A36 | Deno hosting APIs lose previous experimental designation | DenoHostingExtensions.cs full diff vs 13.6.5, removal of Experimental(ASPIREDENO001) |
Cross-reference validation: all 12 current internal targets exist; four pinned source destinations and both README anchors resolve in source; migration URL returns HTTP 200. All added originating PRs were looked up, attribution confirmed, and their labels inspected. No docs-from-code follow-up is required for the authored set.
Frozen Phase B and polish follow-through
Independent report: doc-tester-report.md. Source-blind pass: six sections, eight initial internal links, dark/light desktop/mobile layout, hub discovery passed. Bash completion generation and sourcing executed with 17.0.0+a509f094e0ee87d17dc0e1cc9bca84f7ca2623da. Secret scenario was help-only; no secret storage or cloud deployment executed.
Polish addresses W1 by linking the matching-release migration guide instead of stale site guidance; W2 by linking matching-release emulator READMEs at exact anchors; W3 by explicitly naming GitHub; W4 by specifying current-session completion and AppHost directory. Persistent shell installation remains outside this focused release note and points to originating PR details. W5 is unchanged local /api/live/ 404 context, with no blocking rendering effect.
Fresh validation after all polish: 29 tests across three release metadata/sidebar/catalog suites passed; MDX/frontmatter compilation passed; 12 internal link targets and all pinned source anchors passed; final browser verified all ten H2s and corrected migration/emulator destinations. No new TypeScript/AppHost snippets or twoslash blocks, so twoslash execution is N/A.
Preservation evidence
All five original top-level blocks preserved exactly once, byte-for-byte, in original order:
- Frontmatter/imports/introduction: 832 bytes, SHA256
31ac8676532deafef31c5faaff2708e7aad23cb135f6c1deac0aa1dadd9cce0c. - Upgrade: 779 bytes, SHA256
982aaf4fae694641d1fddb1116252a4f59774fd5e40d0f3b13cfd26c0b5c892c. - Go AppHost: 911 bytes, SHA256
0da96321cb1a4e1c9bde7b502b38dee71a94e11a99c628e70392f083a18f4840. - Container images: 687 bytes, SHA256
c92445350ad9a562ba7ccec9fb2f7cb3daf899e77e9d42e414a5abf6c960add6. - Entire breaking-changes section: 4,978 bytes, SHA256
3689f54fbf7828a6cca7cafde9728b7b08ec4e7031ddd678137aaf9122dbc84c.
Original page SHA256: 963967b38122b2191a808093ea591007d536d9439f55b73dad7c38e5d1a13f20.
Proof compares snapshot and git show 681cdfed:... bytes, then exact block identity, uniqueness, and ordering.
Gate status
Useful validated draft additions; NOT complete research/polish/review modalities. Draft PR must remain draft. Skill release-wide gates for exhaustive coverage, artwork/date, generated ingestion, CI, and blind execution of all scenarios are incomplete. Do not merge, undraft, or claim release-complete.
Phase B — Frozen source-blind doc-tester report
Frozen Phase B documentation test report
Date: 2026-11-15
Tester: Independent, source-blind doc-tester
Draft: http://127.0.0.1:4367/whats-new/aspire-17/
Browser session: release17-blind — closed after testing
Scope: Dashboard updates, CLI updates, AppHost updates, New integrations, Deployment updates, Integration updates.
Independence and limits
Activated doc-tester and playwright-cli. Read the draft and linked local documentation only through playwright-cli. Did not open product source, product clones, implementation/tests, PR #2099, an author's dossier, or any linked GitHub PR/README. Protected Go, Upgrade, Default container image updates, and Breaking changes sections were not evaluated or edited.
No repository code changes, PR comments, local Bun build, global installation, Azure deployment, or cloud provisioning. Browser theme preferences were changed only within the isolated browser context. Generated Bash completion files were removed. No screenshots were needed; observations below use rendered DOM, browser navigation, and terminal output.
This is a frozen browser/user-experience report, not a source-based assertion that product APIs or feature claims are correct.
Summary
| Check | Result |
|---|---|
| Six added sections render and have working TOC destinations | Passed |
| Eight new site-relative LearnMore links clicked | Passed; all open named documentation pages |
| Light/dark themes, desktop 1440×1000 and mobile 390×844 | Passed layout checks |
| Hub discoverability and navigation | Passed |
| Documented Bash completion commands, installed 17.0 CLI | Executed successfully |
| Environment-specific secret scenario | Not executed; command help checked only |
| AppHost/integration examples and dashboard feature behavior | Not executed |
| Azure/AKS/Front Door deployment behavior | Not executed; unauthorized |
Critical issues
None demonstrated. No broken internal LearnMore destinations, missing scoped headings, or failing executed release-note example were observed. Unexecuted product scenarios are not counted as passes.
Warnings
W1 — Path-based AppHost migration needs a publishing caveat
Location: /whats-new/aspire-17/#-apphost-updates → /integrations/frameworks/dotnet/dotnet-host/
Draft: “Use the path-based project model when updating your AppHost.”
Observed follow-through: The linked guide teaches AddDotnetProject / addDotnetProject, but also says:
Automatic project publishing for DotnetProjectResource isn’t currently supported. A plain DotnetProjectResource causes aspire publish and aspire deploy to fail with an actionable error instead of emitting an executable.v0 manifest containing machine-local paths.
It then recommends AddProject<TProject>(...) for referenced C# projects and AddCSharpApp(...) / addCSharpApp(...) for path-based projects requiring standard publishing.
Impact: A reader may treat the release-note migration advice as unconditional and only learn about the deployment trade-off after changing their AppHost. This is a cross-document teaching concern, not a runtime-confirmed failure.
Recommendation: Qualify the new migration advice for apps that publish/deploy, or explicitly direct readers to the guide's publishing limitations before migration.
W2 — Emulator LearnMore pages do not teach the specific announced changes
Location: /whats-new/aspire-17/#-integration-updates
Draft:
Run Azure Web PubSub locally with its emulator using RunAsEmulator.
Reuse a SQL Server resource for the Azure Service Bus emulator instead of creating a separate instance.
See Host Azure Web PubSub, Host Azure Service Bus, and Host Deno apps for configuration examples.
Reproduction: Click the Web PubSub and Service Bus links; read their displayed configuration guidance.
Observed:
/integrations/cloud/azure/azure-web-pubsub/azure-web-pubsub-host/describes Azure provisioning andaddAzureWebPubSub, but its displayed guide has no emulator setup section orRunAsEmulatorinstructions. Its caution says the app must configure an Azure subscription and location./integrations/cloud/azure/azure-service-bus/azure-service-bus-host/teaches emulator setup/configuration, includingRunAsEmulator, but the displayed content does not explain reuse of an existing SQL Server resource. NoWithSqlServer/withSqlServer, shared-SQL, or reuse guidance was found.
Impact: The links are navigationally correct, but a new reader cannot follow them literally to implement these two newly announced local-development features without guessing or opening product material.
Recommendation: Add focused 17.0 examples to these destinations, or link directly to documentation that teaches the announced configuration. Do not send the reader into cloud provisioning to learn an emulator feature.
W3 — Entra ID's guide is an external product README, not a local LearnMore destination
Location: /whats-new/aspire-17/#microsoft-entra-id
Draft: “See the Microsoft Entra ID integration guide for registration, credential, and workload configuration.”
Observed link: https://github.com/microsoft/aspire/blob/a509f094e0ee87d17dc0e1cc9bca84f7ca2623da/src/Aspire.Hosting.Azure.EntraId/README.md
Impact: This is explicitly outside the allowed source-blind test boundary. Availability and teaching quality of that guide remain unverified. The link text does not communicate that it leaves the documentation site.
Recommendation: Label the destination as the integration README on GitHub, or provide a local integration guide. An external README is not itself a broken link; no availability claim is made here.
W4 — CLI snippets need clearer scenario context
Locations: /whats-new/aspire-17/#shell-completion, /whats-new/aspire-17/#environment-specific-secrets
Observed:
- Bash generation and sourcing work. The displayed “installation details” link goes to a product PR rather than a local shell setup guide. The snippet does not say how to persist completion across future shell sessions.
- The secret example correctly tells the reader to set
DATABASE_PASSWORD, but does not state the AppHost working-directory prerequisite or link to the secret command's setup/context documentation. - Installed command help describes
--apphostas an AppHost project path or directory to search, and--environmentas selecting that AppHost's Aspire secrets file.
Impact: A new reader knows the value source but not where to run the secret command or which AppHost will own the secret. I did not fill that gap by selecting the repository's AppHost or writing into a user's existing secret state.
Recommendation: Link to local completion installation and secret-command guidance. Add “Run from your AppHost directory” or another documented explicit AppHost selection instruction, with an isolated example setup if execution is intended.
W5 — Local environment has live-update console errors
Routes: Release-note page and visited documentation pages.
Observed console evidence:
Failed to load resource: the server responded with a status of 404 (Not Found) @ http://127.0.0.1:4367/api/live/
[live-status] Live API not found (404); live updates disabled until reload.
The WebSocket connection also warned about closing before establishment.
Impact: No blocking effect on the tested content/navigation. Treat this as a local-server limitation, not a release-note content defect. No unrelated infrastructure fix is recommended in this pass.
Passed checks
Headings and TOC
Clicked all six TOC entries at desktop and mobile widths. Each URL hash resolved to the expected rendered H2:
| Section | Exact route/hash |
|---|---|
| Dashboard updates | /whats-new/aspire-17/#-dashboard-updates |
| CLI updates | /whats-new/aspire-17/#%EF%B8%8F-cli-updates |
| AppHost updates | /whats-new/aspire-17/#-apphost-updates |
| New integrations | /whats-new/aspire-17/#-new-integrations |
| Deployment updates | /whats-new/aspire-17/#-deployment-updates |
| Integration updates | /whats-new/aspire-17/#-integration-updates |
The compact “On this page” menu had to be expanded before selecting entries; this is normal disclosure behavior. The CLI hash's encoded variation selector resolves correctly. Scoped subordinate headings render: Shell completion, Environment-specific secrets, Microsoft Entra ID, Azure API Management.
Internal LearnMore navigation
Each link was clicked from the draft, with destination URL and rendered page heading verified:
| Link | Destination |
|---|---|
| Host .NET projects | /integrations/frameworks/dotnet/dotnet-host/ |
| Azure API Management | /integrations/cloud/azure/azure-api-management/azure-api-management-get-started/ |
| Deploy to Kubernetes clusters | /deployment/kubernetes/clusters/ |
| Azure Container Apps | /deployment/azure/container-apps/ |
| Azure App Service | /deployment/azure/app-service/ |
| Host Azure Web PubSub | /integrations/cloud/azure/azure-web-pubsub/azure-web-pubsub-host/ |
| Host Azure Service Bus | /integrations/cloud/azure/azure-service-bus/azure-service-bus-host/ |
| Host Deno apps | /integrations/frameworks/deno/deno-host/ |
All eight are site-relative, end with /, and resolve without a not-found document. There are no anchor fragments on these eight links.
Rendering and mobile
- Light and dark selections update
data-themeand foreground/background colors. - Desktop document width remained 1440px at a 1440px viewport; both new CLI blocks fit their 1036px containers.
- Mobile document/main widths remained 390px at a 390px viewport in both themes.
- Mobile CLI blocks stay within 356px containers and scroll horizontally with
overflow-x: autorather than widening the page. Their content scroll widths were 592px and 1004px. - All six mobile TOC clicks succeeded with no page-wide horizontal overflow.
- These are DOM/layout checks, not a screenshot-based aesthetic or full accessibility certification.
Hub discoverability
At /hub/browse/, entering Aspire 17 into “Search resources...” produced two results, including What's new in Aspire 17.0, labeled Release notes. Clicking its card opened /whats-new/aspire-17/ with the correct H1. No release-date or artwork promise was assumed or evaluated.
Teaching strengths
- Dashboard prose explains the investigation workflow and gives a conditional fallback rather than promising universal availability.
- Secret prose explicitly distinguishes masked interactive input from non-interactive
--envvar/value requirements. - AppHost prose distinguishes the AppHost minimum framework requirement from requirements on every orchestrated workload.
- Entra ID explicitly warns that identity references do not install authentication middleware or secure routes.
- API Management explicitly explains deployment-only behavior and local
aspire runlimitations. - Deployment prose distinguishes stable packages from experimental APIs, states a Helm minimum, and calls out Private Link approval.
- Linked Container Apps and App Service guides repeat the Private Link approval requirement.
Exact CLI execution evidence
Available executable: /Users/midenn/.aspire/bin/aspire
aspire --version returned:
17.0.0+a509f094e0ee87d17dc0e1cc9bca84f7ca2623da
No 17.1 or stable 13.6 executable was substituted.
Actually executed, copied literally from the rendered Shell completion snippet, inside .doc-tester-workspace/release17-blind/:
aspire completions script bash > aspire-completion.bash
source ./aspire-completion.bashBoth succeeded. A shell check confirmed _aspire_complete and _aspire_decode_ansi_c functions were registered. This confirms script generation and sourcing, not interactive Tab-completion behavior or Fish/PowerShell/Zsh behavior.
Help-only check, not the scenario: aspire secret set --help succeeded and displayed the documented -e/--environment, --envvar, optional value, and non-interactive options.
Not executed:
aspire secret set Parameters:database-password --environment production --envvar DATABASE_PASSWORDNo isolated AppHost was supplied by the new section, and I did not choose an existing AppHost or mutate user secret state to fill that gap. Masked prompting, environment isolation, actual secret storage, and consuming a stored secret remain untested.
Knowledge gaps and recommendations
- AppHost migration/publishing: A reader needs to know which path-based API preserves publishing. This gap was learned from the linked documentation, not product source. Add a caveat/link; do not assume familiarity with the resource models.
- Local emulator setup: A reader needs the actual emulator and SQL-reuse calls, prerequisites, and minimal AppHost configuration. I did not infer APIs from prior knowledge. Update the linked guides before treating LearnMore as implementation guidance.
- CLI context: A reader needs AppHost selection and persistent shell-completion setup. Command help partially exposes the AppHost requirement; the release-note example does not. Provide local instructional links.
- Dashboard operation: Pinning, grouping, shared resource selection, and fallback availability were read but not exercised in a running 17.0 dashboard. No product UX conclusion is asserted.
- Entra ID: README reachability, credentials, registration/reference behavior, and consuming authentication configuration remain unverified because following the link would breach the source-blind boundary.
- Deployment/integrations: Package availability, AppHost compilation, stable/experimental designations, Helm compatibility, AKS-existing-cluster targeting, Front Door approvals, and emulator runtime behavior require a separately authorized execution/source-validation pass. No Azure deployment was attempted.
Recommended handoff: Address W1–W4 as documentation follow-through improvements. Keep W5 separate as local environment context. Preserve this Phase B report unchanged; it does not authorize edits or certify the unexecuted product scenarios.
Frontend HTML artifact readyThe latest frontend build uploaded the This comment updates automatically when a new frontend build artifact is uploaded. |
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Mitch Denny (mitchdenny)
left a comment
There was a problem hiding this comment.
Follow-up validation: CLI sources, Entra guide and TestShop artwork
Source: microsoft/aspire release/17.0 at a509f094e0ee87d17dc0e1cc9bca84f7ca2623da, published13.6.5 comparison b33d222049f1ecc3bc7257ec07b622fe550b2580. Frozen initial36 + follow-up18 grouped claims verified; 0 contradicted/unverifiable. Initial Phase B remains in the prior review. New independent blind Phase B exercised only the follow-up sections: 0 critical issues, 2 warnings (illustrative team inputs and user-permitted TODO complete guides). This is not release-complete sign-off.
Final screenshot revision 6847506b7079d519717581246ff961a348444751: actual pinned17.0 TestShop in both themes, real site theme swap validated,29 targeted tests passed, MDX/assets and unchanged byte-preservation verifier passed. All five original blocks remain byte-identical and ordered; no Eric guides/assets modified. New imports are outside protected blocks. No local site build.
Phase A — Claim verification
Initial frozen36-claim catalog
Product source: microsoft/aspire release/17.0 SHA a509f094e0ee87d17dc0e1cc9bca84f7ca2623da.
Published comparison: v13.6.5 SHA b33d222049f1ecc3bc7257ec07b622fe550b2580.
No fallback to main, 17.1 daily, Community Toolkit, or Azure SDK main.
The following 36 product claims were individually checked against the pinned source. Verdicts: 36 verified, 0 contradicted, 0 unverifiable. Narrative statements and contributor attribution are not included in this product-claim denominator.
| ID | Normalized claim | Pinned evidence |
|---|---|---|
| A01 | Shared resource pane persists context across telemetry tabs | src/Aspire.Dashboard/Components/Layout/ResourcesLayout.razor.cs:866,1094-1106 |
| A02 | Pane supports search/filter/multiple selection | ResourcesLayout.razor, selection bindings and filter controls |
| A03 | Grouping by tags/resource type/state | ResourcesLayout.razor.cs:1361-1430 |
| A04 | Metrics display cards with live sparklines | src/Aspire.Dashboard/Components/Pages/Metrics.razor:214-271 |
| A05 | Instruments can be pinned | Metrics.razor.cs:326-333,379-384 |
| A06 | Previous experience is conditional and selectable in Settings | Components/Dialogs/SettingsDialog.razor.cs:110-122, Components/DashboardExperienceComponents.cs:25 |
| A07 | CLI exposes completions script subcommand | src/Aspire.Cli/Commands/CompletionsCommand.cs:14-36 |
| A08 | Accepted explicit shells are bash/fish/pwsh/zsh | src/Aspire.Cli/Completions/CompletionScripts.cs, SupportedShells |
| A09 | Completion script is written to stdout for redirection | CompletionsCommand.cs:44-57; exact pinned CLI execution succeeded |
| A10 | Secret commands support environment and -e | src/Aspire.Cli/Commands/SecretCommand.cs:16-29 |
| A11 | Omitted value opens secret input prompt | src/Aspire.Cli/Commands/SecretSetCommand.cs:96-98 |
| A12 | --envvar reads a named environment variable | SecretSetCommand.cs:26-31,81-92 |
| A13 | Noninteractive requires value or environment source | SecretSetCommand.cs:57-60 |
| A14 | Aspire minimum supported .NET is 10 | eng/Versions.props:11-12, diff from 13.6.5; PR #20614 |
| A15 | Requirement does not mandate .NET 10 for all orchestrated workloads | Separate Go/JavaScript workload hosting remains available; #20614 targets Aspire framework support |
| A16 | Dotnet hosting package now uses stable versioning | src/Aspire.Hosting.Dotnet/Aspire.Hosting.Dotnet.csproj:8-10, SuppressFinalPackageVersion removed vs 13.6.5 |
| A17 | AddProject is deprecated, retained | src/Aspire.Hosting/ProjectResourceBuilderExtensions.cs:71,110,125,383 |
| A18 | Entra hosting integration is new compared with baseline | New src/Aspire.Hosting.Azure.EntraId/Aspire.Hosting.Azure.EntraId.csproj |
| A19 | Entra package remains preview | Same csproj:8, SuppressFinalPackageVersion=true |
| A20 | Entra can provision registrations/service principals | EntraIdResourceExtensions.cs:59, provisioning code and pinned README |
| A21 | Existing Entra registrations can be referenced | EntraIdResourceExtensions.cs:371,433 |
| A22 | Entra references supply identity configuration | EntraIdResourceExtensions.cs:54-56, reference callbacks |
| A23 | Referencing Entra does not install authentication middleware | EntraIdResourceExtensions.cs:56, README authentication guidance |
| A24 | APIM hosting package is new and preview | New csproj, SuppressFinalPackageVersion=true |
| A25 | APIM models APIs/backends/policies | src/Aspire.Hosting.Azure.ApiManagement/AzureApiManagementExtensions.cs:180 and AddBackend/policy APIs |
| A26 | OpenAPI can come from file or reachable deployed endpoint | Same extensions, WithOpenApiDocument/WithOpenApiEndpoint; ordering at :78-106 |
| A27 | APIM is not provisioned in local run | Same extensions:109-112, CreateResourceBuilder rather than AddResource/provisioning |
| A28 | Kubernetes hosting packages stable | csproj SuppressFinalPackageVersion removed, PR #20936 |
| A29 | Some persistent-volume APIs remain experimental | KubernetesPersistentVolumeExtensions.cs and AzureKubernetesPersistentVolumeExtensions.cs Experimental(ASPIRECOMPUTE002) |
| A30 | Helm minimum is 4.0.0 | src/Aspire.Hosting.Kubernetes/Deployment/HelmVersionValidator.cs, MinimumHelmVersion |
| A31 | Existing AKS environments can be targeted | src/Aspire.Hosting.Azure.Kubernetes/AzureKubernetesEnvironmentExtensions.cs:128-149,896-1003 |
| A32 | Front Door Private Link supports provisioned ACA and App Service | src/Aspire.Hosting.Azure.FrontDoor/AzureFrontDoorPrivateLinkExtensions.cs:90-114 |
| A33 | Front Door Private Link API remains experimental | Same file:131-132 |
| A34 | Private endpoint must be approved before traffic flows | Same file:98-100 |
| A35 | Web PubSub supports local RunAsEmulator; Service Bus supports SQL resource reuse | AzureWebPubSubExtensions.cs:180, AzureServiceBusExtensions.cs:708 |
| A36 | Deno hosting APIs lose previous experimental designation | DenoHostingExtensions.cs full diff vs 13.6.5, removal of Experimental(ASPIREDENO001) |
Cross-reference validation: all 12 current internal targets exist; four pinned source destinations and both README anchors resolve in source; migration URL returns HTTP 200. All added originating PRs were looked up, attribution confirmed, and their labels inspected. No docs-from-code follow-up is required for the authored set.
Frozen18-claim follow-up catalog and evidence
18 grouped follow-up claims verified; 0 contradicted or unverifiable. These extend the frozen initial 36-claim review, not a claim that every release feature is covered. Source paths below are under microsoft/aspire/src/Aspire.Cli at the pinned SHA unless stated otherwise.
| ID | Claim | Evidence |
|---|---|---|
| C01 | Named template sources are used by aspire new |
Commands/TemplateManagementCommand.cs, Templating/ConfiguredTemplateSourceService.cs |
| C02 | Source can be an absolute local path, or repository/path/ref | Commands/TemplateManagementCommand.cs:30-61, Templating/TemplateSourceConfiguration.cs:99 |
| C03 | Template registration is global and asks for trust confirmation | Commands/TemplateManagementCommand.cs, matching CLI aspire template source add --help |
| C04 | integrationSources permits named local/feed sources |
Packaging/IntegrationSourceConfiguration.cs:16-28,151-159 |
| C05 | Patterns filter exact IDs, prefixes or all packages | IntegrationSourceConfiguration.cs:28,163 |
| C06 | Built-in integration discovery remains unless disabled | IntegrationSourceConfiguration.cs:20,90-116 |
| C07 | skillSources supplies marketplace repositories and plugins |
Agents/AspireSkills/SkillSource.cs:16,35-44 |
| C08 | Skill source defaults, enabled flag and optional ref are supported | SkillSource.cs:32-48,102-123 |
| C09 | Copilot/Claude marketplaces and OpenCode catalogs are supported | SkillSource.cs:18-19,122-123; agent-specific initialization implementations |
| C10 | aspire agent init --skills aspire applies configured enabled sources |
Commands/AgentInitCommand.cs; matching help and linked skills documentation |
| C11 | ASPIRE_INIT_SOURCE_URL specifies shared source repository |
CliConfigNames.cs:11, Configuration/ConfigSourceService.cs:160-181 |
| C12 | Source acceptance requires consent, accepts true/false override | ConfigSourceService.cs:154-221; matching init help |
| C13 | Materialization allows skill/integration settings and records local source binding | ConfigSourceService.cs:37,376-402 and saved-source code |
| C14 | Explicit shared source templates are inherited, not materialized | ConfigSourceService.cs:314-373 |
| C15 | Source path defaults to aspire.config.json, optional ref selects branch/tag/commit |
CliConfigNames.cs:12-13, ConfigSourceService.cs:181,334,373 |
| C16 | aspire update --config-source refreshes adopted configuration |
Commands/UpdateCommand.cs; matching update help |
| C17 | Entra LearnMore targets Eric's existing canonical complete site guide | aspire.dev/integrations/security/microsoft-entra-id/index.mdx, no slug override; local HTTP 200; #2086/#2111 authorship |
| C18 | Screenshot/alt show real TestShop in the 17.0 dashboard | testshop-capture-report.md, matching CLI/dashboard binary path and package nuspec commits; actual UI visually reviewed |
The four principal source files were added after published 13.6.5: baseline comparison reports 1,468 added lines and no preexisting version of these files. No published 13.6.x backport assumed new.
Phase B — Independent blind revision report (verbatim)
Documentation Test Report
Focus Area: PR2166 follow-up revisions only; blind Phase B.
Date: 2026-11-16 (Australia/Sydney)
Tester: doc-tester with playwright-cli, isolated browser revision17-blind
Served page: http://127.0.0.1:4368/whats-new/aspire-17/
PR ref: Caller-provided current PR2166 working tree; no checkout, source inspection, commit, edit of repository content, push, or build.
Summary
Outcome: 0 critical issues; 2 documentation warnings. Rendering, revised internal links, skills anchor, image loading, genuine theme swapping, and page-width checks passed. CLI help validates command surfaces only: no custom-source scenario was executed end to end.
The frozen initial six-section review was not repeated. Scope was the H3 Custom templates, integrations, and skills, its four H4s, the changed Microsoft Entra ID integration LearnMore destination, and the inserted TestShop image under Dashboard updates. No product-source code or parent's source evidence was consulted.
| Category | Result |
|---|---|
| Revised content structure | Four H4s and their minimal examples present; trust/replacement/consent notes readable |
| Code examples | Two rendered JSON examples parse successfully; zero scenarios compiled or executed |
| CLI commands | Version and four help commands successful; behavioral execution intentionally excluded |
| Links | Six revised internal destinations return HTTP 200; skills anchor exists |
| Image/theme | Two genuinely different image assets load in matching light/dark themes |
| Responsive layout | Desktop 1440px and mobile 390px have no page horizontal overflow |
Routes exercised
All navigation used playwright-cli against the existing local server.
| Route | Browser result |
|---|---|
/whats-new/aspire-17/ |
Release page renders; scoped sections inspected |
/reference/cli/commands/aspire-new/ |
HTTP 200; “aspire new command” |
/integrations/custom-integrations/hosting-integrations/ |
HTTP 200; “Create custom hosting integrations” |
/reference/cli/configuration/#configure-ai-agent-plugins-and-skill-sources |
HTTP 200; exact heading/anchor exists |
/reference/cli/commands/aspire-init/ |
HTTP 200; “aspire init command” |
/reference/cli/commands/aspire-update/ |
HTTP 200; “aspire update command” |
/integrations/security/microsoft-entra-id/ |
HTTP 200; “Microsoft Entra ID integration” |
The custom-skills cross-reference and Entra LearnMore were also clicked from the release page, confirming actual client-side navigation to their correct destinations. The Entra click succeeded; an initial broad h1 inspection hit Astro dev-toolbar headings, so confirmation used main h1 instead. This was a test locator issue, not a site defect.
All scoped internal links are site-relative with trailing slashes before any fragment. The four H4 self-links target existing IDs: custom-templates, custom-integrations, custom-skills, and init-source-mechanism.
Critical Issues
None observed within these revisions. No claim of full runtime feature accuracy or successful end-to-end execution is made.
Warnings
Warning 1: Minimal examples require user-owned illustrative inputs
Location: /whats-new/aspire-17/#custom-templates-integrations-and-skills
The rendered examples use:
/absolute/path/to/team-templates— an illustrative directory, not a supplied template collection../packagesandTeam.Hosting.*— a user-populated package directory and illustrative package-name pattern, not a verified published package.example-org/team-skills, marketplaceteam-skills, pluginplatform— illustrative names, not a verified installable marketplace/plugin.https://github.com/example-org/aspire-defaults.git— an illustrative configuration repository, not a runnable supplied source.
The page explicitly says “Replace the path with a directory containing your templates,” “Place your Team.Hosting.* NuGet packages in the packages directory,” and “Replace the repository, marketplace, and plugin names with your own.” It also says “Replace the URL with your configuration repository.”
These caveats are clear and reduce confusion, but the examples are not executable out of the box. No fictional repository was invoked, no plugin installed, no package discovery attempted, and no template source registered globally. Valid JSON parsing and help output do not establish discovery, plugin installation, or configuration adoption success.
Suggestion: Keep the explicit replacement/trust notes; link a complete authoring walkthrough with supplied safe inputs when available.
Warning 2: Three complete guides are still explicitly TODO
Location: Custom templates, Custom integrations, Init source mechanism.
The browser visibly renders:
TODO: Add complete documentation for authoring templates and managing named template sources.
TODO: Add complete documentation for named integration sources and package filtering.
TODO: Add a complete guide to shared configuration sources and their activation environment variables.
These are clear acknowledgments of incompleteness, not broken links. Existing aspire new, hosting-authoring, aspire init, and aspire update destinations load, but they do not make these minimal release-note fragments complete runnable walkthroughs.
Suggestion: Replace TODOs with complete guides covering preparation, adoption, discovery, refresh, and removal, without presenting the current fragments as tested recipes.
Passed Checks
Four H4s and teaching clarity
- Custom templates: Local registration command and
aspire neware rendered in a named code block; replacement path and global registration/trust implications are stated. - Custom integrations:
integrationSourcesJSON renders and parses;source: "./packages"andpatterns: ["Team.Hosting.*"]are readable; package preparation and built-in-source note are visible. - Custom skills:
skillSourcesJSON renders and parses; replacement values andaspire agent init --skills aspireare visible. The linked anchor contains agent-specific fields, OpenCode V1/V2 catalog fields, source defaults, and the caveat that disabling registration does not uninstall previously registered content. This was read as documentation, not independently verified behavior. - Init source mechanism: Environment-variable example and replacement repository note render; consent, explicit accept/decline flags, optional defaults, activation path/ref variables, and refresh command are stated.
TestShop image: actual loading and genuine theme swap
The page uses this descriptive alt:
TestShop running in the Aspire 17.0 dashboard, with its resource list and dependency graph shown side by side.
Visually inspected screenshots show TestShop's resource list at left and dependency graph at right, matching the alt. Theme changes were made through the site's real Dark and Light radio controls, not CSS recoloring or an emulated screenshot.
| Theme | Actual currentSrc asset encoded in local /_image/ URL |
Decode |
|---|---|---|
| Light | testshop-dashboard-light.png |
complete: true, natural size 1280 × 800 |
| Dark | testshop-dashboard.png |
complete: true, natural size 1280 × 800 |
Both desktop variants were visually inspected and contain genuinely different dashboard backgrounds. Switching back to Light at 390px restored the light asset; the dark mobile capture uses the dark asset.
At 390 × 844, each image occupied x=16 through x=374, width=358, height=224.5 CSS pixels. The full image fit the page without clipping or horizontal overflow. Screenshot text is naturally small at that scaled width; the descriptive alt still accurately identifies its content.
Visual evidence: revision17-light-desktop.png, revision17-dark-desktop.png, revision17-light-mobile.png, revision17-dark-mobile.png, revision17-custom-desktop.png, and revision17-custom-mobile.png alongside this report.
Desktop/mobile page width
- Desktop:
innerWidth = document.documentElement.scrollWidth = 1440, both dashboard image themes and each revised H4. - Mobile:
innerWidth = document.documentElement.scrollWidth = 390, both image themes and each revised H4. - Mobile code blocks retain contained
overflow-x: auto; measured client width 356px, scroll widths 745px (templates), 377px (integrations), 473px (skills), and 880px (init example). This is intentional code-block scrolling, not page horizontal overflow.
Verifiable installed CLI checks
The following commands completed successfully with exit code 0:
| Exact command | Observed evidence |
|---|---|
aspire --version |
17.0.0+a509f094e0ee87d17dc0e1cc9bca84f7ca2623da |
aspire template source add --help |
<name>, --path, --repository, --ref; help explicitly describes global configuration and trust confirmation |
aspire agent init --help |
--skills includes aspire; agent IDs include copilot, claude, opencode; project/global scope options |
aspire init --help |
--use-config-source; help says specify false to decline |
aspire update --help |
--config-source and --use-config-source; help describes refresh of saved Git configuration settings |
These were help-only checks. They do not verify actual consent prompts, Boolean parsing during execution, environment-variable activation, copying/merging settings, package filters, template discovery, agent downloads, or refresh behavior.
Recommendations
- No critical rendering/link fix is indicated by this focused run.
- Preserve the explicit trust and replacement caveats.
- Prioritize the three TODO guides; supply complete prerequisites and reproducible examples.
- Keep the genuine theme-specific TestShop assets and descriptive alt.
- Parent should combine these blind findings with its separate source-claims review before PR publication.
Knowledge Gaps and Unexecuted Scenarios
What a new user still needs: A real unpacked template collection and authoring steps; real hosting NuGet packages and discovery/filter setup; an accessible team marketplace/plugin or OpenCode catalog; and a real shared configuration repository with adoption/refresh lifecycle instructions.
Source of knowledge: Only rendered documentation and installed CLI help. No intrinsic/product-source knowledge was used to fill these gaps or turn illustrative names into working fixtures.
User impact: Readers without existing team assets cannot complete these examples literally. The TODO labels and replacement notes accurately signal this, but do not supply those assets or missing guides.
Unexecuted: Template registration/creation, NuGet discovery, plugin/catalog installation, config-source adoption/refresh and consent, activation environment variables, Entra setup, and running TestShop or another AppHost. No secrets were created.
Environment observation: The local site's console reported a 404 for /api/live/; scoped pages and both images loaded normally. This is not attributed to the follow-up changes or promoted to a PR critical issue.
Cleanup and Isolation
Only browser revision17-blind was closed. Parent's server was left running and untouched. No extra application, build, source checkout, global source registration, or PR publication occurred. The report and its screenshots are the retained deliverables.
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Custom CLI example revisionThe template subsection now teaches one-off The fork owner and branch are explicitly illustrative replacements. Ref semantics permit branch, tag or full commit SHA; absent a ref, remote HEAD is used. One-off The integration example now uses the explicitly illustrative NuGet service index Evidence
Checks
No example private feed or fork was contacted. No global template source registered, app generated, plugin installed or cloud deployment performed. Help/source/manifest checks are not claimed as end-to-end template execution. No local site build. |
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
There was a problem hiding this comment.
🟡 Changes recommended
The release notes incorrectly document tag support for ASPIRE_INIT_SOURCE_REF and direct readers to the Toolkit Deno integration rather than the core Deno APIs.
2 open issues
What changed in this PR
Expands the Aspire 17.0 release-note draft with additional feature highlights while preserving the existing curated sections.
Changes:
- Adds a four-part TestShop dashboard tour with paired light and dark screenshots.
- Documents CLI completion, environment-specific secrets, and custom template, integration, skill, and configuration sources.
- Adds AppHost migration, new integration, Kubernetes, and Azure deployment highlights with supporting references.
| File | Description |
|---|---|
src/frontend/src/content/docs/whats-new/aspire-17.mdx |
Expands the release notes with the dashboard tour and feature guidance, leaving protected content unchanged. |
Review effort: Balanced
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
|
Addressed both factual findings in b8a93e6: the init-source selector now documents branches/full commit SHAs only, and the Deno link targets the pinned core integration README. Original curated blocks remain byte-for-byte unchanged. 🤖 AI-authored reply via Agency Finish PR. |

Summary
Replacement draft for closed #2099, starting from the existing
release/17.0page, not abandoned changes. Uses thewhatsnewresearch/authoring/critique/validation lifecycle; the user-selected working branch targets release/17.0, overriding generic skill branching guidance. No site-wide banner/version/data/localization edits.TestShop dashboard tour: four H3 stops with concise explanations and matching light/dark
ThemeImagepairs:testshop-all-resources(-light).png, 1280×800testshop-dashboard(-light).pngreused byte-identically, 1280×800frontend: status, endpoint, logs and telemetrytestshop-resource(-light).png, 1280×800testshop-traces(-light).png, 1280×540 crop from full-height viewportReal activity: browsed catalog pages, added hoodie and mug, submitted the sample checkout form and verified the cart changed from two items to zero. TestShop's activity generator supplemented user actions. The selected trace is explicitly generator traffic, not misrepresented as the checkout trace. Overview includes actual checkout endpoints. No fabricated telemetry, payment details or external purchase.
Version provenance: product
microsoft/aspire release/17.0ata509f094e0ee87d17dc0e1cc9bca84f7ca2623da, compared with published 13.6.5 atb33d222049f1ecc3bc7257ec07b622fe550b2580. Installed CLI17.0.0+a509f094e0ee87d17dc0e1cc9bca84f7ca2623da; bundled new dashboard reports 17.0.0. Scoped TestShop copy replaces repository-only references with staging packages whose nuspec commits all matcha509f094, preserving actual resource declarations. No 17.1 UI. Dashboard executable SHA-256:032300cf23b332da62d168e9628e7f48b79ab9bc1b3df2fee06df93a54b75c6f.All six new PNGs optimized and visually reviewed. Application resources were healthy; genuine missing unused parameters, frontend HTTP-redirect warning and six failed internal event traces remain visible. Sample checkout completed. Banners/toasts dismissed; no exposed secrets. Task-owned apps/browser/containers stopped; unrelated apps and existing documentation preview untouched.
Earlier follow-ups retained: custom CLI H3 with four H4s, minimal examples and site references or permitted TODO complete guides. Exact
ASPIRE_INIT_SOURCE_URLrepository selection, consent, allowed settings, template inheritance, optional path/ref and refresh documented. Entra links to Eric's complete site guide; no guides changed. Earlier dashboard/CLI/AppHost/integration/deployment additions remain.Eric's curation unchanged: five original complete blocks remain byte-identical, unique and ordered against docs baseline
681cdfeddfa290dbe94cea0830ec1ea885bf1ed1. New imports stay after the complete protected Upgrade block. Original imports/frontmatter, preservation verifier and curated assets remain untouched. Existing graph pair hashes unchanged.31ac8676532deafef31c5faaff2708e7aad23cb135f6c1deac0aa1dadd9cce0c982aaf4fae694641d1fddb1116252a4f59774fd5e40d0f3b13cfd26c0b5c892c0da96321cb1a4e1c9bde7b502b38dee71a94e11a99c628e70392f083a18f4840c92445350ad9a562ba7ccec9fb2f7cb3daf899e77e9d42e414a5abf6c960add63689f54fbf7828a6cca7cafde9728b7b08ec4e7031ddd678137aaf9122dbc84cRemaining gaps; not release-complete: three permitted TODO complete guides and illustrative team inputs; release-wide coverage/contributors, migration/diagnostic/image-tag details, data ingestion and CI/build/sign-off. Protected
resourceImage, publish date and original summaries unchanged; no date invented. Article artwork is present but resource-card frontmatter gate remains incomplete. Secrets/cloud/team-source scenarios are not fully runtime-certified. No remaining dashboard capture blocker.Third-party links and affiliations
Originating
microsoft/aspirePR links and three exact 17.0 source documents (migration, Web PubSub emulator, Service Bus emulator); Entra uses the site guide. Team repository examples are explicit placeholders. Material affiliation disclosure was not provided. No unrelated third-party sites added.Validation
git diff --check— passed.python3 /Users/midenn/.copilot/session-state/819dd6e8-33ab-4dbb-ae69-455637977e2a/files/verify-preservation.py— passed on final committed tour, all five original blocks exact, unique and ordered; original verifier/baseline unchanged, session-only.src/frontend:npm exec --yes --package=bun@1.4.3 -- bun x vitest run --config vitest.config.ts tests/unit/whats-new.vitest.test.ts tests/unit/whats-new-sidebar.vitest.test.ts tests/unit/dev-resource-catalog.vitest.test.ts— passed after tour, 29 tests in three suites.node --input-type=moduleusingparseFrontmatter,@mdx-js/mdx.compile,sharp.metadataand SHA-256 — passed, final MDX, four H3 tour stops, fourThemeImageinstances/eight matching assets, expected dimensions and unchanged graph hashes. Prior CLI JSON/H4/link checks passed.ASTRO_TELEMETRY_DISABLED=1 npm exec --yes --package=bun@1.4.3 -- bun run dev -- --host 127.0.0.1 --port 4368— refused, existing same-worktree server registered. Did not force-replace it; reusedhttp://localhost:15623/on IPv6 loopback.playwright-cli -s=tour17-doc-check run-code— passed, all four images decoded and selected the actual correct asset through both native site themes at 1440px and 390px; expected dimensions and no page/image overflow. Desktop/light/mobile visually inspected. Only task browser closed; existing server untouched.aspire start --non-interactive --isolated --apphost TestShop/TestShop.AppHost/TestShop.AppHost.csproj --launch-profile http --format Json,aspire wait frontend,aspire wait activity-generator— passed. Actual catalog/cart/sample-checkout UI actions and ten-span propagated service/database trace verified. Task capture tools/apps stopped; original source clone untouched.aspire --version,aspire template source add --help,aspire new --help,aspire agent init --help,aspire init --help,aspire update --help— passed, help-only. Initial Bash completion generation/sourcing — passed; secret help — passed, storage scenario unexecuted.bun run build(prohibited), cloud provisioning/deployment, full data ingestion or release sign-off. No twoslash introduced. Unrelated pre-existing icon delta excluded from commits.