feat(aspire): enable browser-logs devtools integration by default + streams HTTP/2 caveat (#218)

[rickylabs]

Summary

Enables Aspire browser logs for generated TypeScript AppHosts by default so generated Fresh/Vite app resources can forward browser console output into the Aspire dashboard. Also documents the local HTTP/1.1 concurrent-connection caveat for durable-stream HTTP/SSE consumers.

This intentionally builds on the merged #222 AppHost generator state: generate-aspire-config.ts and the register helpers keep the isolated-port OTLP exporter behavior, including withOtlpExporter({ protocol: OtlpProtocol.HttpProtobuf }) and the OtlpProtocol import.

Scope

• Archetype / area: Archetype 6 CLI/tooling, area: aspire/docs
• Adds Aspire.Hosting.Browsers to generated TypeScript AppHost aspire.config.json.
• Emits withBrowserLogs() for generated Type: 'app' resources after HTTP endpoint binding.
• Adds generator tests for the browser logs package and app-resource call.
• Adds a streams docs warning about local HTTP/1.1 per-origin connection limits and HTTPS/HTTP2.

Slices

• S1 browser logs AppHost generation — 3dfbbb5d
• S2 streams HTTP/2 caveat — 3dfbbb5d

Validation

• aspire docs get browser-logs — confirmed TypeScript API .withBrowserLogs() and package Aspire.Hosting.Browsers.
• aspire integration search browsers --format Json — confirmed Aspire.Hosting.Browsers version 13.4.6-preview.1.26319.6.
• PLAN-EVAL — first pass FAIL_PLAN for gate specificity; updated plan; rerun PASS.
• deno test --allow-all packages/cli/src/kernel/templates/aspire/helpers/tests/ — PASS, 13 passed / 123 steps.
• deno test --allow-all packages/cli/src/kernel/templates/aspire/generate-aspire-config_test.ts packages/cli/src/kernel/templates/aspire/helpers/tests/generators-background-app_test.ts — PASS.
• deno run --allow-read --allow-run .llm/tools/run-deno-check.ts --root packages/cli/src/kernel/templates/aspire --ext ts,tsx — PASS.
• rtk proxy deno task check — PASS, 1885 files / 16 batches.
• deno lint --no-config <5 touched CLI files> — PASS. Repo config-backed lint/fmt target selection excludes packages/cli; recorded in run drift.
• deno task check:assets-barrel — PASS.
• Focused scaffold: deno run -A packages/cli/bin/netscript-dev.ts init browser-logs-smoke --path .llm/tmp/run/aspire-browser-logs-default--218/scaffold --db none --ci --yes --no-git --force — PASS.
• Generated AppHost: aspire restore then deno check --unstable-kv --sloppy-imports apphost.mts .helpers/register-apps.mts — PASS.
• Generated AppHost: npx tsc --noEmit --project tsconfig.apphost.json — PASS.
• Docs: from docs/site, deno task build && deno task check:links && deno task check:caveats — PASS.

Harness

• Run dir: .llm/tmp/run/aspire-browser-logs-default--218/
• Phase: impl

Drift / Debt

• Drift recorded locally: repo config-backed lint/fmt target selection excludes packages/cli and docs Markdown; no source debt introduced.
• Debt: none.

Closes #218

[augmentcode]

🤖 Augment PR Summary

Summary: Enables Aspire browser console log forwarding for generated TypeScript AppHosts by default and documents a local HTTP/1.1 concurrency caveat for SSE streams.

Changes:

• Adds Aspire.Hosting.Browsers to generated TypeScript AppHost aspire.config.json packages
• Emits .withBrowserLogs() for generated Type: 'app' resources after .withHttpEndpoint()
• Adds generator tests covering the new package pin and helper emission
• Updates Streams docs with a warning about per-origin HTTP/1.1 connection limits and recommending HTTPS/HTTP/2 for many SSE consumers

Technical Notes: The browser logs integration is pinned to 13.4.6-preview.1.26319.6 to match the current Aspire TypeScript surface.

_{🤖 Was this summary useful? React with 👍 or 👎}

[augmentcode]

Review completed. No suggestions at this time.

Comment augment review to trigger a new review at any time.