Superseded: Prepare mcp_dart 2.5.0 release

[leehack]

Superseded by #363 after selecting the patch release version and renaming the head branch to release/2.4.1-prep.

GitHub automatically closed this draft when its remote head branch was renamed. The validated commits and release-prep scope continue unchanged in #363.

[Copilot]

Pull request overview

Prepares the mcp_dart SDK 2.5.0 stable release (keeping mcp_dart_cli at 0.2.0) by updating release metadata and all release-facing documentation, and by adding per-file Dart language version markers in nested packages/examples to preserve their intended minimum SDK language versions during analysis (e.g., Pana/monorepo tooling).

Changes:

• Bump the SDK stable version to 2.5.0 in pubspec.yaml and release metadata.
• Update release-facing docs/policies (README, roadmap, runbook, security policy, quick refs, llms.txt, changelog) to consistently reference 2.5.0.
• Add // @dart=... language markers across nested CLI/example sources to align analysis with each package’s declared minimum.

Reviewed changes

Copilot reviewed 31 out of 32 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
tool/release/mcp_2026_07_28_release_metadata.json	Updates stable SDK version in release metadata to 2.5.0.
test/tool/validate_release_metadata_test.dart	Adjusts release-metadata test fixture rewriting for updated security policy formatting.
SECURITY.md	Updates supported stable SDK line to 2.5.x.
ROADMAP.md	Updates baseline and Tier 1 inventory references to 2.5.0.
README.md	Updates stable version references, snippets, and pub.dev doc link to 2.5.0.
pubspec.yaml	Bumps package version to 2.5.0.
packages/mcp_dart_cli/lib/src/utils/inspect_handlers.dart	Adds Dart language version marker for CLI sources.
packages/mcp_dart_cli/lib/src/update_command.dart	Adds Dart language version marker for CLI sources.
packages/mcp_dart_cli/lib/src/trace_command.dart	Adds Dart language version marker for CLI sources.
packages/mcp_dart_cli/lib/src/serve_command.dart	Adds Dart language version marker for CLI sources.
packages/mcp_dart_cli/lib/src/inspectors/inspection_report.dart	Adds Dart language version marker for CLI sources.
packages/mcp_dart_cli/lib/src/create_command.dart	Adds Dart language version marker for CLI sources.
packages/mcp_dart_cli/lib/src/conformance_command.dart	Adds Dart language version marker for CLI sources.
packages/mcp_dart_cli/lib/src/builders/mason_bundle_builder.dart	Adds Dart language version marker for CLI sources.
packages/mcp_dart_cli/lib/src/agent_skill_command.dart	Adds Dart language version marker for CLI sources.
packages/mcp_dart_cli/bin/mcp_dart.dart	Adds Dart language version marker for CLI entrypoint.
llms.txt	Updates stable SDK version and release summary to 2.5.0.
example/jaspr-client/lib/app.dart	Adds Dart language version marker for the Jaspr example package.
example/gemini-client/test/gemini_client_test.dart	Adds Dart language version marker for the Gemini example package tests.
example/gemini-client/test/fixtures/env_probe_server.dart	Adds Dart language version marker for the Gemini example package tests/fixtures.
example/gemini-client/test/cli_smoke_test.dart	Adds Dart language version marker for the Gemini example package tests.
example/gemini-client/lib/gemini_client.dart	Adds Dart language version marker for the Gemini example package library.
example/flutter_http_client/lib/services/streamable_mcp_service.dart	Adds Dart language version marker for the Flutter HTTP example package.
example/flutter_http_client/lib/screens/mcp_client_screen.dart	Adds Dart language version marker for the Flutter HTTP example package.
example/anthropic-client/test/fixtures/env_probe_server.dart	Adds Dart language version marker for the Anthropic example package tests/fixtures.
example/anthropic-client/test/anthropic_client_test.dart	Adds Dart language version marker for the Anthropic example package tests.
example/anthropic-client/lib/anthropic_client.dart	Adds Dart language version marker for the Anthropic example package library.
doc/sdk-tier-1-feature-coverage.md	Updates published stable SDK reference to 2.5.0.
doc/quick-reference.md	Updates version snippets and stable-profile description to 2.5.0.
doc/mcp-2026-07-28-release-runbook.md	Updates runbook steps/examples to reference the 2.5.0 release.
doc/getting-started.md	Updates dependency snippet to ^2.5.0.
CHANGELOG.md	Finalizes release notes under ## 2.5.0 and references PRs included.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 85.87%. Comparing base (7314500) to head (0ddc330).

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #362   +/-   ##
=======================================
  Coverage   85.87%   85.87%           
=======================================
  Files          82       82           
  Lines       20531    20531           
=======================================
  Hits        17631    17631           
  Misses       2900     2900           

Flag	Coverage Δ
cli	78.11% <ø> (ø)
unittests	88.31% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[Copilot]

Pull request overview

Copilot reviewed 30 out of 31 changed files in this pull request and generated no new comments.

Suppressed comments (2)

pubspec.yaml:3

• The PR title/description state this is preparing the mcp_dart 2.5.0 release (and describes it as a minor release), but the package version is set to 2.4.1. This creates a mismatch between the stated release intent and the actual publish version used by tooling (pub.dev, release scripts, changelog tags, etc.). Please align the PR metadata and all versioned files (pubspec/changelog/docs/release metadata) on the intended release version.

version: 2.4.1

CHANGELOG.md:8

• Under the ### Fixed section, this bullet starts with "Added", which reads like a new feature rather than a fix and is internally inconsistent with the section heading. Rewording to "Fixed" keeps the changelog semantics clear for readers and tooling.

- Added missing Streamable HTTP access and JSON-RPC error diagnostics. Default