Repository navigation
Draft Aspire 17.0 release notes against 13.6.4 - #2099
Closed
Mitch Denny (mitchdenny) wants to merge 2 commits into
Closed
Mitch Denny (mitchdenny) wants to merge 2 commits into
Mitch Denny (mitchdenny) wants to merge 2 commits into
Conversation
Expand the existing draft against Aspire 13.6.4 with verified feature coverage, migration guidance, and release-note closing sections. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Contributor
Frontend HTML artifact readyThe latest frontend build uploaded the This comment updates automatically when a new frontend build artifact is uploaded. |
Explain application and resource context, scoped telemetry views, and the verified previous-dashboard opt-out flow. Include paired light/dark screenshots with explicit daily-build provenance. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
4 of 10 tasks
Member
Author
|
Abandoning this draft at the author’s request. Replacement work will use the repository whatsnew skill and preserve Eric Erhardt’s curated sections. |
Mitch Denny (mitchdenny)
added a commit
that referenced
this pull request
Nov 16, 2026
…#2166) ## Summary <!-- Describe what this pull request changes and why. --> Replacement **draft** for closed #2099, starting from the existing `release/17.0` page, not abandoned changes. Uses the `whatsnew` research/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 `ThemeImage` pairs: | View | Captured subject | Assets | | --- | --- | --- | | All resources | Resource list, live request activity, latency and slowest endpoints | New `testshop-all-resources(-light).png`, 1280×800 | | Resource graph | Service/infrastructure dependencies | Existing `testshop-dashboard(-light).png` reused byte-identically, 1280×800 | | Resource details | Storefront `frontend`: status, endpoint, logs and telemetry | New `testshop-resource(-light).png`, 1280×800 | | Distributed traces | One real ten-span waterfall across frontend/catalog/PostgreSQL/basket/Redis | New `testshop-traces(-light).png`, 1280×540 crop from full-height viewport | **Real 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.0` at `a509f094e0ee87d17dc0e1cc9bca84f7ca2623da`, compared with published 13.6.5 at `b33d222049f1ecc3bc7257ec07b622fe550b2580`. Installed CLI `17.0.0+a509f094e0ee87d17dc0e1cc9bca84f7ca2623da`; bundled new dashboard reports 17.0.0. Scoped TestShop copy replaces repository-only references with staging packages whose nuspec commits all match `a509f094`, 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_URL` repository selection, consent, allowed settings, template inheritance, optional path/ref and refresh documented. Entra links to [Eric's complete site guide](https://aspire.dev/integrations/security/microsoft-entra-id/); 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. | Protected block | Bytes | SHA-256 | | --- | ---: | --- | | Frontmatter, imports, introduction | 832 | `31ac8676532deafef31c5faaff2708e7aad23cb135f6c1deac0aa1dadd9cce0c` | | Upgrade | 779 | `982aaf4fae694641d1fddb1116252a4f59774fd5e40d0f3b13cfd26c0b5c892c` | | Go AppHost | 911 | `0da96321cb1a4e1c9bde7b502b38dee71a94e11a99c628e70392f083a18f4840` | | Default container images | 687 | `c92445350ad9a562ba7ccec9fb2f7cb3daf899e77e9d42e414a5abf6c960add6` | | Entire breaking-changes section | 4,978 | `3689f54fbf7828a6cca7cafde9728b7b08ec4e7031ddd678137aaf9122dbc84c` | **Remaining 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 <!-- 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. --> Originating `microsoft/aspire` PR 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 <!-- List the checks you ran or explain why validation isn't needed. --> - `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. - From `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=module` using `parseFrontmatter`, `@mdx-js/mdx.compile`, `sharp.metadata` and SHA-256 — **passed**, final MDX, four H3 tour stops, four `ThemeImage` instances/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; reused `http://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. - Capture: `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. - Earlier independent blind follow-up: **0 critical issues, 2 warnings** for placeholders/permitted TODOs. Six site destinations, skills anchor, Entra navigation and original artwork theme/mobile checks passed. Frozen report remains historical, not relabeled as independent review of the later tour. Initial source review: 36 claims; custom follow-up: 18 grouped claims verified at pinned SHA. Tour captions match actual captured UI/state. - Matching `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. - **Not run:** local `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.
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.
Summary
Expand the existing
whats-new/aspire-17.mdxinto an evidence-backed initial draft, targeting release/17.0, not main. This is intentionally a draft for continued release work, not a claim of complete 17.0 coverage. Changes are confined to the release-note page and its dashboard screenshot assets.Pinned comparison: latest published stable patch
v13.6.4(c89352703f78ae46de90fbf751ed8b52b77b89bf) versusmicrosoft/aspirerelease/17.0atcec195f2d0bf3f1d714badf74f205fa855fdf963. Read the 514 target-side commit subjects and inspected selected implementations, source guides, and originating PRs. Explicitly excluded servicing fixes already shipped in 13.6.x, including DCP create recovery, Azure enum-expression publishing, Unix diagnostic-log permissions, and dashboard metric/Fluent UI servicing changes.Verified initial coverage:
resourceImageartwork. The sample's existing activity generator produced actual read-only traffic; no telemetry or UI was fabricated.ReleaseCommunityusage.Dashboard capture provenance and qualification:
At the user's request, installed the latest daily CLI in session-only storage and ran matching TestShop source with published daily packages and the bundled daily dashboard. Version 17.1.0-preview.1.26559.12, source 031536bc9eea22ee9ce2cc1d31bfd30d0c14cfd2. The article explicitly labels this as the latest development experience, not finalized 17.0 artwork. Shared capabilities and the opt-out flow were separately checked in the pinned release/17.0 source. Main has subsequent UI refinements, notably microsoft/aspire#21943; reconcile artwork and exact navigation against the final release build before sign-off. The scratch sample used isolated ports/secrets and no source-built dashboard. Task-owned TestShop, persistent RabbitMQ and preview/browser helpers were stopped; unrelated running apps and pre-existing generated icon changes were left untouched.
Remaining before release sign-off:
publishDate; replace the moving branch-comparison link with final release metadata when available.Third-party links and affiliations
Added https://github.com/thomhurst solely for attribution of the originating Service Bus emulator contribution; no material affiliation declared. Existing RabbitMQ and MongoDB migration-guide links are unchanged. Other new external references point to the Microsoft Aspire source repository and its pull requests.
Validation
Latest dashboard pass:
pnpm --dir src/frontend exec prettier --write src/content/docs/whats-new/aspire-17.mdx— passed, unchanged by formatting.pnpm --dir src/frontend exec vitest run --config vitest.config.ts tests/unit/whats-new.vitest.test.ts tests/unit/whats-new-sidebar.vitest.test.ts tests/unit/custom-components.vitest.test.ts— passed, 3 files / 118 tests.git diff --check— passed.aspire start --isolated --non-interactive --apphost <session-owned TestShop.AppHost.csproj>— passed after standalone SDK setup; sample built with 0 warnings / 0 errors.aspire wait frontendandaspire wait activity-generator— passed. Resource selection across telemetry views, metrics pinning, and the full opt-out/return flow — passed in the actual daily dashboard.curl -fsSLon the new pinned TestShop source link — passed, HTTP 200.pnpm --dir src/frontend exec astro dev --host 127.0.0.1 --port 4387plusplaywright-clichecks — passed: all 14 optimized image URLs return images; all 7 ThemeImage components switch correctly in both themes; all 5 screenshot tabs operate; image zoom works; article fragments resolve; no skipped heading levels or page overflow at 390px mobile width. Visually inspected desktop/mobile renders and both-theme captures. Temporary preview was stopped. Standalone Astro's unavailable/api/live/endpoint and initial dev-toolbar optimize-cache 504 remain preview-only limitations.Initial draft validation, before the dashboard follow-up:
pnpm --dir ./src/frontend exec prettier --check src/content/docs/whats-new/aspire-17.mdx— passed.pnpm --dir ./src/frontend exec vitest run --config vitest.config.ts tests/unit/whats-new.vitest.test.ts tests/unit/whats-new-sidebar.vitest.test.ts tests/unit/release-contributors.vitest.test.ts tests/unit/seo-lengths.vitest.test.ts tests/unit/twoslash-blocks.vitest.test.ts— passed, 5 files / 15 tests, including the two-slash TypeScript example.No local production build or complete matching-17.0 runtime qualification was run. Pre-existing generated icon-cache changes are not included.