From a5e2b44eddaf47765f29576b101ae3bb3403ba2f Mon Sep 17 00:00:00 2001 From: Jhin Lee Date: Mon, 19 Oct 2026 10:03:43 -0400 Subject: [PATCH] Prepare CLI 0.2.2 release --- README.md | 14 +++++++------- ROADMAP.md | 5 +++-- doc/quick-reference.md | 2 +- llms.txt | 4 ++-- packages/mcp_dart_cli/CHANGELOG.md | 6 ++++++ packages/mcp_dart_cli/README.md | 8 ++++---- packages/mcp_dart_cli/example/example.md | 2 +- packages/mcp_dart_cli/lib/src/version.dart | 4 ++-- packages/mcp_dart_cli/pubspec.yaml | 4 ++-- packages/templates/simple/__brick__/pubspec.yaml | 2 +- tool/release/mcp_2026_07_28_release_metadata.json | 2 +- 11 files changed, 30 insertions(+), 23 deletions(-) diff --git a/README.md b/README.md index 53375876..bb002f75 100644 --- a/README.md +++ b/README.md @@ -15,8 +15,8 @@ extensions, host UI behavior, an authorization-server implementation, JSON Schema external-reference resolution, and custom JSON Schema vocabularies. > [!IMPORTANT] -> This release is `mcp_dart 2.4.3`. The separately versioned stable CLI remains -> `mcp_dart_cli 0.2.1`, which requires `mcp_dart ^2.4.2`. +> This release is `mcp_dart 2.4.3`. The separately versioned CLI is +> `mcp_dart_cli 0.2.2`, which requires `mcp_dart ^2.4.3`. > Current source passes every scored requirement in the official alpha.11 MCP > `2025-11-25` and `2026-07-28` client and server sets, including all 25 > required 2026 authorization scenarios, plus bidirectional published @@ -41,7 +41,7 @@ The public maintenance contract is documented in the | Package | Minimum Dart SDK | | --- | --- | | `mcp_dart 2.4.3` | 3.4 | -| `mcp_dart_cli 0.2.1` | 3.12 | +| `mcp_dart_cli 0.2.2` | 3.12 | SDK-only generated projects retain the SDK's Dart 3.4 minimum. CLI projects use Dart 3.12 because the CLI and its toolchain target that release. @@ -72,8 +72,8 @@ The snippets below use the current stable SDK line. Package versions remain separate from protocol profiles: `McpProtocol.stable` names the SDK's default compatibility policy. -The SDK and CLI are versioned independently. The stable CLI's `^2.4.2` -constraint accepts SDK versions from 2.4.2 up to, but not including, 3.0.0. +The SDK and CLI are versioned independently. The stable CLI's `^2.4.3` +constraint accepts SDK versions from 2.4.3 up to, but not including, 3.0.0. ### AI agent skills @@ -165,13 +165,13 @@ Applications upgrading from the stable 2.2 line should also follow the Install the matching stable CLI: ```bash -dart pub global activate mcp_dart_cli 0.2.1 +dart pub global activate mcp_dart_cli 0.2.2 mcp_dart create my_server cd my_server mcp_dart inspect ``` -The `0.2.1` CLI creates a project with `mcp_dart: ^2.4.2`. The inspector +The `0.2.2` CLI creates a project with `mcp_dart: ^2.4.3`. The inspector launches the generated stdio server itself. After leaving the interactive inspector, you can run a single tool directly: diff --git a/ROADMAP.md b/ROADMAP.md index ba609a75..202b12ad 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -10,8 +10,9 @@ through the ## Current baseline -- SDK 2.4.3 release preparation adds packaged agent skills and documentation - fixes. Published stable releases remain `mcp_dart 2.4.2` and +- Published SDK 2.4.3 adds packaged agent skills and documentation fixes. + CLI 0.2.2 release preparation adds support for `build` 5.x while retaining + compatibility with 4.x. The published stable CLI remains `mcp_dart_cli 0.2.1` until publication is verified. - SDK 2.4.2 fixes unbounded incoming stdio and IO stream buffering. See [GHSA-92g6-8c2f-55w5](https://github.com/leehack/mcp_dart/security/advisories/GHSA-92g6-8c2f-55w5) diff --git a/doc/quick-reference.md b/doc/quick-reference.md index 46586c72..f1f07933 100644 --- a/doc/quick-reference.md +++ b/doc/quick-reference.md @@ -15,7 +15,7 @@ dependencies: import 'package:mcp_dart/mcp_dart.dart'; ``` -The 2.4.3 SDK requires Dart 3.4 or later. The stable 0.2.1 CLI requires +The 2.4.3 SDK requires Dart 3.4 or later. The stable 0.2.2 CLI requires Dart 3.12 or later. ## Protocol profile diff --git a/llms.txt b/llms.txt index b03e656b..470b2f8f 100644 --- a/llms.txt +++ b/llms.txt @@ -4,7 +4,7 @@ (MCP) servers, clients, and hosts. - SDK release: `2.4.3` -- CLI stable: `0.2.1` +- CLI stable: `0.2.2` - SDK minimum: Dart 3.4 - CLI minimum: Dart 3.12 - Repository: https://github.com/leehack/mcp_dart @@ -212,7 +212,7 @@ https://github.com/leehack/mcp_dart/tree/main/example/authentication Install the coordinated stable CLI: ```bash -dart pub global activate mcp_dart_cli 0.2.1 +dart pub global activate mcp_dart_cli 0.2.2 ``` Common commands: diff --git a/packages/mcp_dart_cli/CHANGELOG.md b/packages/mcp_dart_cli/CHANGELOG.md index 5c54c504..6b43ceaa 100644 --- a/packages/mcp_dart_cli/CHANGELOG.md +++ b/packages/mcp_dart_cli/CHANGELOG.md @@ -1,3 +1,9 @@ +## 0.2.2 + +- Support `build` 5.x while retaining compatibility with 4.x. The Dart 3.12 + minimum is unchanged. +- Require `mcp_dart ^2.4.3` for the CLI and newly generated projects. + ## 0.2.1 - Require `mcp_dart ^2.4.2` for the CLI and newly generated projects. diff --git a/packages/mcp_dart_cli/README.md b/packages/mcp_dart_cli/README.md index c924d777..5065e9c0 100644 --- a/packages/mcp_dart_cli/README.md +++ b/packages/mcp_dart_cli/README.md @@ -11,17 +11,17 @@ Install the stable CLI with a Dart SDK allowed by that release: dart pub global activate mcp_dart_cli ``` -The `0.2.1` release requires Dart 3.12. +The `0.2.2` release requires Dart 3.12. Install the coordinated MCP `2026-07-28` CLI: ```bash -dart pub global activate mcp_dart_cli 0.2.1 +dart pub global activate mcp_dart_cli 0.2.2 ``` For coordinated releases, automation publishes the SDK first and waits for it to resolve from pub.dev before publishing the CLI. CLI-only releases validate -against the already published minimum SDK, currently `mcp_dart 2.4.2`. +against the already published minimum SDK, currently `mcp_dart 2.4.3`. Without Dart, install the latest stable standalone binary: @@ -46,7 +46,7 @@ cd my_server mcp_dart serve ``` -The 0.2.1 CLI writes `mcp_dart: ^2.4.2`, the SDK version tested with this +The 0.2.2 CLI writes `mcp_dart: ^2.4.3`, the SDK version tested with this CLI. You can also supply a local Mason brick, Git URL, GitHub shorthand, or tree URL: diff --git a/packages/mcp_dart_cli/example/example.md b/packages/mcp_dart_cli/example/example.md index 1cdbee69..27ff3fcd 100644 --- a/packages/mcp_dart_cli/example/example.md +++ b/packages/mcp_dart_cli/example/example.md @@ -11,7 +11,7 @@ First, install the CLI globally: dart pub global activate mcp_dart_cli # Coordinated MCP 2026-07-28 release -dart pub global activate mcp_dart_cli 0.2.1 +dart pub global activate mcp_dart_cli 0.2.2 ``` ## Creating a Project diff --git a/packages/mcp_dart_cli/lib/src/version.dart b/packages/mcp_dart_cli/lib/src/version.dart index 5332a3bf..10dbf26a 100644 --- a/packages/mcp_dart_cli/lib/src/version.dart +++ b/packages/mcp_dart_cli/lib/src/version.dart @@ -1,7 +1,7 @@ -const packageVersion = '0.2.1'; +const packageVersion = '0.2.2'; /// SDK constraint written by this CLI when it creates a project. -const generatedSdkConstraint = '^2.4.2'; +const generatedSdkConstraint = '^2.4.3'; /// Immutable template paired with this CLI release. const defaultTemplateUrl = diff --git a/packages/mcp_dart_cli/pubspec.yaml b/packages/mcp_dart_cli/pubspec.yaml index a3cae85a..35f769ad 100644 --- a/packages/mcp_dart_cli/pubspec.yaml +++ b/packages/mcp_dart_cli/pubspec.yaml @@ -1,6 +1,6 @@ name: mcp_dart_cli description: Command-line tools for creating Dart MCP servers and inspecting, tracing, or testing Model Context Protocol servers and clients in any language. -version: 0.2.1 +version: 0.2.2 repository: https://github.com/leehack/mcp_dart homepage: https://github.com/leehack/mcp_dart/tree/main/packages/mcp_dart_cli issue_tracker: https://github.com/leehack/mcp_dart/issues @@ -26,7 +26,7 @@ dependencies: build: ">=4.0.3 <6.0.0" mason: ^0.1.2 mason_logger: ^0.3.3 - mcp_dart: ^2.4.2 + mcp_dart: ^2.4.3 meta: ^1.17.0 path: ^1.9.1 pub_updater: ">=0.5.0 <0.7.0" diff --git a/packages/templates/simple/__brick__/pubspec.yaml b/packages/templates/simple/__brick__/pubspec.yaml index 9830dcbc..4406690d 100644 --- a/packages/templates/simple/__brick__/pubspec.yaml +++ b/packages/templates/simple/__brick__/pubspec.yaml @@ -9,7 +9,7 @@ environment: dependencies: args: ^2.6.0 logging: ^1.3.0 - mcp_dart: ^2.4.2 + mcp_dart: ^2.4.3 dev_dependencies: # Dart 3.4 resolves lints 4.0; Dart 3.8+ can use the latest lints 6 release. diff --git a/tool/release/mcp_2026_07_28_release_metadata.json b/tool/release/mcp_2026_07_28_release_metadata.json index 1be7f5f7..becc7e0e 100644 --- a/tool/release/mcp_2026_07_28_release_metadata.json +++ b/tool/release/mcp_2026_07_28_release_metadata.json @@ -1,6 +1,6 @@ { "sdkStableVersion": "2.4.3", - "cliStableVersion": "0.2.1", + "cliStableVersion": "0.2.2", "protocolVersion": "2026-07-28", "legacyInitializationProtocolVersion": "2025-11-25", "coreSpecification": {