[docs] Update aspire do --list-steps docs to require step argument

.github/agents/community-toolkit-integration-doc-writer.agent.md

@@ -162,7 +162,7 @@ This step ensures that the documentation you've created is properly indexed and
 ### AppHost language parity
 
 - Follow the `doc-writer` skill's AppHost language parity guidance for all AppHost and hosting-integration examples.
-- Always show both C# AppHost (`AppHost.cs`) and TypeScript AppHost (`apphost.ts`) variants inside synced `Tabs` (with `syncKey='aspire-lang'`) unless the feature is genuinely language-specific or TypeScript AppHost support does not exist yet.
+- Always show both C# AppHost (`AppHost.cs`) and TypeScript AppHost (`apphost.mts`) variants inside synced `Tabs` (with `syncKey='aspire-lang'`) unless the feature is genuinely language-specific or TypeScript AppHost support does not exist yet.
 - Before writing a TypeScript AppHost example, verify the API exists in the TypeScript AppHost SDK. Do not invent TypeScript samples.
 - If TypeScript AppHost support is not available, show only the C# example without language tabs and add a note that TypeScript AppHost support for the integration is not yet available.
 - Use language-neutral prose around AppHost examples, such as "Add a resource to your AppHost" instead of C#-specific method instructions.

.github/skills/aspire/SKILL.md

@@ -5,7 +5,7 @@ description: "Orchestrates Aspire distributed applications using the Aspire CLI
 
 # Aspire Skill
 
-This repository uses Aspire to orchestrate its distributed application. Resources are defined in the AppHost project (`apphost.cs` or `apphost.ts`).
+This repository uses Aspire to orchestrate its distributed application. Resources are defined in the AppHost project (`apphost.cs` or `apphost.mts`).
 
 ## CLI command reference
 

.github/skills/doc-writer/SKILL.md

@@ -73,8 +73,36 @@ description: A brief summary of the page content (required for SEO)
 Optional frontmatter fields:
 
 - `next: false` - Disable "Next page" link for terminal pages
+- `seoTitle` - Override the page's `og:title` / `twitter:title` only,
+  without touching the visible H1 or sidebar label. Use this **only**
+  when the natural H1 must stay short (commands, terse labels). When
+  set, the value is emitted verbatim — no `· Aspire` suffix is appended.
 - Custom metadata as needed by Starlight theme
 
+#### SEO length targets
+
+The site uses Open Graph metadata to render social cards and feed SEO
+tooling. To keep previews scannable on every social network and to
+avoid the "title too short / description too long" lints that surface
+on Yoast, LinkedIn, and the search-console reports, follow these
+length targets when authoring frontmatter:
+
+| Field         | Composed length target | Hard limit |
+| ------------- | ---------------------: | ---------: |
+| `title`       | 41-51 characters       | 70 characters |
+| `seoTitle`    | 50-60 characters       | 70 characters |
+| `description` | 110-160 characters     | 200 characters (auto-truncated) |
+
+`title` becomes `og:title` composed as `${title} · Aspire`, so the
+target window leaves room for the 9-character suffix. `seoTitle`
+overrides the composition outright — write the full string yourself.
+
+Surface keywords from the article body itself in the description
+(verbs, integration names, API surfaces). The CI guard at
+`tests/unit/seo-lengths.vitest.test.ts` fails when any English page
+strays outside the wider 30-65 / 80-200 character guard ranges, so a
+draft can land slightly off-target and tighten in follow-ups.
+
 ### Required Imports
 
 Import Starlight components at the top of your MDX file:
@@ -368,8 +396,8 @@ builder.Build().Run();
 ````
 
 ````mdx
-```typescript title="apphost.ts"
-import { createBuilder } from "./.modules/aspire.js";
+```typescript title="apphost.mts"
+import { createBuilder } from "./.aspire/modules/aspire.mjs";
 
 const builder = await createBuilder();
 
@@ -407,7 +435,7 @@ For client/library packages:
 
 ## AppHost Language Parity (C# and TypeScript)
 
-Aspire supports both **C# AppHosts** (`AppHost.cs`) and **TypeScript AppHosts** (`apphost.ts`). Documentation must treat both languages as first-class citizens. **Always show both C# and TypeScript code samples for AppHost code unless the feature is genuinely language-specific or TypeScript support does not exist yet.** Never write AppHost or hosting-integration documentation with a C#-only bias.
+Aspire supports both **C# AppHosts** (`AppHost.cs`) and **TypeScript AppHosts** (`apphost.mts`). Documentation must treat both languages as first-class citizens. **Always show both C# and TypeScript code samples for AppHost code unless the feature is genuinely language-specific or TypeScript support does not exist yet.** Never write AppHost or hosting-integration documentation with a C#-only bias.
 
 ### Core Principles
 
@@ -440,8 +468,8 @@ builder.Build().Run();
 </TabItem>
 <TabItem id='typescript' label='TypeScript'>
 
-```typescript title="apphost.ts"
-import { createBuilder } from "./.modules/aspire.js";
+```typescript title="apphost.mts"
+import { createBuilder } from "./.aspire/modules/aspire.mjs";
 
 const builder = await createBuilder();
 
@@ -467,10 +495,10 @@ If a section heading should appear in the **On this page** table of contents, ke
 
 | Aspect           | C#                                              | TypeScript                                                                                                          |
 | ---------------- | ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
-| File title       | `title="AppHost.cs"`                            | `title="apphost.ts"`                                                                                                |
+| File title       | `title="AppHost.cs"`                            | `title="apphost.mts"`                                                                                                |
 | Tab wrapper      | Shared `<Tabs syncKey='aspire-lang'>` container | Shared `<Tabs syncKey='aspire-lang'>` container                                                                     |
 | Tab item         | `<TabItem id='csharp' label='C#'>`              | `<TabItem id='typescript' label='TypeScript'>`                                                                      |
-| Builder creation | `DistributedApplication.CreateBuilder(args)`    | `import { createBuilder } from './.modules/aspire.js';` then newline for space followed by `await createBuilder();` |
+| Builder creation | `DistributedApplication.CreateBuilder(args)`    | `import { createBuilder } from './.aspire/modules/aspire.mjs';` then newline for space followed by `await createBuilder();` |
 | Method casing    | PascalCase (`AddRedis`)                         | camelCase (`addRedis`)                                                                                              |
 | Async pattern    | Synchronous fluent calls                        | `await` each builder call                                                                                           |
 | Build & run      | `builder.Build().Run()`                         | `await builder.build().run()`                                                                                       |
@@ -565,8 +593,8 @@ builder.Build().Run();
 </TabItem>
 <TabItem id='typescript' label='TypeScript'>
 
-```typescript title="apphost.ts"
-import { createBuilder } from "./.modules/aspire.js";
+```typescript title="apphost.mts"
+import { createBuilder } from "./.aspire/modules/aspire.mjs";
 
 const builder = await createBuilder();
 
@@ -616,8 +644,8 @@ builder.Build().Run();
 </TabItem>
 <TabItem id='typescript' label='TypeScript'>
 
-```typescript title="apphost.ts"
-import { createBuilder } from "./.modules/aspire.js";
+```typescript title="apphost.mts"
+import { createBuilder } from "./.aspire/modules/aspire.mjs";
 
 const builder = await createBuilder();
 

src/frontend/astro.config.mjs

@@ -125,7 +125,7 @@ export default defineConfig({
         starlightLinksValidator({
           errorOnRelativeLinks: false,
           errorOnFallbackPages: false,
-          exclude: ['/i18n/'],
+          exclude: ['/i18n/', '/reference/api', '/reference/api/**'],
         }),
         starlightScrollToTop({
           // https://frostybee.github.io/starlight-scroll-to-top/svg-paths/

src/frontend/config/redirects.mjs

@@ -175,6 +175,9 @@ export const redirects = {
   '/integrations/devtools/flagd/': '/integrations/devtools/flagd/flagd-get-started/',
   '/integrations/devtools/goff/': '/integrations/devtools/goff/goff-get-started/',
   '/integrations/devtools/mailpit/': '/integrations/devtools/mailpit/mailpit-get-started/',
+  '/integrations/frameworks/go/': '/integrations/frameworks/go/go-get-started/',
+  '/integrations/frameworks/go-apps/': '/integrations/frameworks/go/go-get-started/',
+  '/ja/integrations/frameworks/go-apps/': '/integrations/frameworks/go/go-get-started/',
   '/integrations/frameworks/csharp-file-based-apps/': '/integrations/dotnet/csharp-file-based-apps/',
   '/integrations/frameworks/maui/': '/integrations/dotnet/maui/',
   '/fundamentals/service-defaults/': '/get-started/csharp-service-defaults/',

src/frontend/config/sidebar/docs.topics.ts

@@ -90,6 +90,10 @@ export const docsTopics: StarlightSidebarTopicsUserConfig = {
       label: "What's new",
       collapsed: true,
       items: [
+        {
+          label: 'Aspire 13.4',
+          slug: 'whats-new/aspire-13-4',
+        },
         {
           label: 'Aspire 13.3',
           slug: 'whats-new/aspire-13-3',

src/frontend/config/sidebar/integrations.topics.ts

@@ -1248,7 +1248,7 @@ export const integrationTopics: StarlightSidebarTopicsUserConfig = {
             },
           ],
         },
-        { 
+        {
           label: 'SQLite',
           collapsed: true,
           items: [
@@ -1332,13 +1332,35 @@ export const integrationTopics: StarlightSidebarTopicsUserConfig = {
             { label: 'C# file-based apps', slug: 'integrations/dotnet/csharp-file-based-apps' },
             { label: 'Launch profiles', slug: 'integrations/dotnet/launch-profiles' },
             { label: '.NET tool resources', slug: 'integrations/dotnet/dotnet-tool-resources' },
+            {
+              label: 'Blazor',
+              collapsed: true,
+              items: [
+                { label: 'Get started', slug: 'integrations/dotnet/blazor-get-started' },
+                { label: 'Set up Blazor hosting in the AppHost', slug: 'integrations/dotnet/blazor-hosting' },
+                { label: 'Connect Blazor apps and APIs', slug: 'integrations/dotnet/blazor-connect' },
+              ],
+            },
             { label: '.NET MAUI', slug: 'integrations/dotnet/maui' },
             { label: 'WPF and Windows Forms', slug: 'integrations/frameworks/wpf-winforms' },
             { label: 'Orleans', slug: 'integrations/frameworks/orleans' },
           ],
         },
         { label: 'Dapr', slug: 'integrations/frameworks/dapr' },
-        { label: 'Go', slug: 'integrations/frameworks/go-apps' },
+        {
+          label: 'Go',
+          collapsed: true,
+          items: [
+            {
+              label: 'Get started',
+              slug: 'integrations/frameworks/go/go-get-started',
+            },
+            {
+              label: 'Set up Go apps in the AppHost',
+              slug: 'integrations/frameworks/go/go-host',
+            },
+          ],
+        },
         { label: 'Java', slug: 'integrations/frameworks/java' },
         {
           label: 'JavaScript and Node.js',

src/frontend/config/sidebar/reference.topics.ts

@@ -602,6 +602,10 @@ export const referenceTopics: StarlightSidebarTopicsUserConfig[number] = {
               label: 'ASPIREEXPORT013',
               link: '/diagnostics/aspireexport013',
             },
+            {
+              label: 'ASPIREEXPORT016',
+              link: '/diagnostics/aspireexport016',
+            },
             {
               label: 'ASPIRECERTIFICATES001',
               link: '/diagnostics/aspirecertificates001',
@@ -666,6 +670,10 @@ export const referenceTopics: StarlightSidebarTopicsUserConfig[number] = {
               label: 'ASPIREPOSTGRES001',
               link: '/diagnostics/aspirepostgres001',
             },
+            {
+              label: 'ASPIREPROCESSCOMMAND001',
+              link: '/diagnostics/aspireprocesscommand001',
+            },
             {
               label: 'ASPIREUSERSECRETS001',
               link: '/diagnostics/aspireusersecrets001',
@@ -708,6 +716,10 @@ export const referenceTopics: StarlightSidebarTopicsUserConfig[number] = {
               label: 'ASPIREEXPORT004',
               link: '/diagnostics/aspireexport004',
             },
+            {
+              label: 'ASPIREEXPORT015',
+              link: '/diagnostics/aspireexport015',
+            },
             {
               label: 'ASPIREHOSTINGPYTHON001',
               link: '/diagnostics/aspirehostingpython001',

src/frontend/config/twoslash.config.mjs

@@ -41,7 +41,8 @@ export const TWOSLASH_ENABLED = true;
  * `typescript` package from `ec.config.mjs`).
  *
  * - `moduleResolution: 100` → `ts.ModuleResolutionKind.Bundler` so
- *   `./.modules/aspire.js` falls through to the virtual `.modules/aspire.ts`.
+ *   `./.aspire/modules/aspire.mjs` falls through to the virtual
+ *   `.aspire/modules/aspire.mts`.
  * - `module: 99` → `ts.ModuleKind.ESNext` (paired with bundler resolution).
  * - `target: 99` → `ts.ScriptTarget.ESNext` so `lib.esnext.full.d.ts` is the
  *   default `lib`, pulling in `Date`, `URL`, DOM, and friends via TS's
@@ -79,12 +80,12 @@ export function readAspireTypes() {
 /**
  * Returns the `extraFiles` map twoslash should mount in its VFS. Returns an
  * empty object when the SDK bundle is missing so twoslash can still compile
- * blocks that don't import from `./.modules/aspire.js` (they'll just see
+ * blocks that don't import from `./.aspire/modules/aspire.mjs` (they'll just see
  * `any` for the missing module — same fallback `ec.config.mjs` had inline).
  */
 export function getTwoslashExtraFiles() {
   const { source } = readAspireTypes();
-  return source ? { '.modules/aspire.ts': source } : {};
+  return source ? { '.aspire/modules/aspire.mts': source } : {};
 }
 
 /**