@bdayadev/flutter-ultra-mcp 1.9.3 → 1.10.0

package/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
     {
       "name": "flutter",
       "description": "Durable cross-platform Flutter automation via 8 specialized MCP servers, in-app mixin binding, and an optional DevTools panel. Replaces marionette_mcp and the official dart mcp-server for Claude Code.",
-      "version": "1.9.3",
+      "version": "1.10.0",
       "author": {
         "name": "Bdaya-Dev",
         "url": "https://github.com/Bdaya-Dev"
@@ -23,5 +23,5 @@
       "tags": ["flutter", "dart", "mcp", "testing", "automation", "patrol", "cross-platform"]
     }
   ],
-  "version": "1.9.3"
+  "version": "1.10.0"
 }

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "flutter",
-  "version": "1.9.3",
+  "version": "1.10.0",
   "description": "Durable cross-platform Flutter automation via 8 specialized MCP servers, in-app mixin binding, and an optional DevTools panel. Replaces marionette_mcp and the official dart mcp-server for Claude Code.",
   "author": {
     "name": "Bdaya-Dev",

package/dart/ultra_flutter/README.md

@@ -26,11 +26,14 @@ void main() {
 class AppBinding extends WidgetsFlutterBinding
     with SentryWidgetsBindingMixin, UltraFlutterBinding {}
 
-void main() {
+void main() async {
   if (kDebugMode) {
-    AppBinding.ensureInitialized();
+    AppBinding();
+  } else {
+    WidgetsFlutterBinding.ensureInitialized();
   }
-  // ...
+  await SentryFlutter.init((options) { /* ... */ });
+  runApp(const MyApp());
 }
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bdayadev/flutter-ultra-mcp",
-  "version": "1.9.3",
+  "version": "1.10.0",
   "description": "Flutter Ultra MCP plugin monorepo — 8 MCP servers + ultra_flutter Dart packages + skills for Claude Code.",
   "license": "Apache-2.0",
   "homepage": "https://github.com/Bdaya-Dev/flutter-ultra-mcp",

package/skills/setup/SKILL.md

@@ -5,7 +5,7 @@ description: One-command setup of the flutter-ultra-mcp plugin in an existing Fl
 
 # Plugin Setup
 
-Expected end state: `UltraFlutterBinding` initialized in the app entry point, `ultra_flutter` in `dev_dependencies`, patrol fork overridden if needed, and a smoke launch confirming the VM Service attaches correctly.
+Expected end state: `UltraFlutterBinding` initialized in the app entry point, `ultra_flutter` in `dependencies`, patrol fork overridden if needed, and a smoke launch confirming the VM Service attaches correctly.
 
 ## Workflow
 
@@ -17,10 +17,10 @@ Expected end state: `UltraFlutterBinding` initialized in the app entry point, `u
 - `mcp__plugin_flutter_flutter-ultra-build__list_dart_defines` — discover required dart-defines for launch.
 - `mcp__plugin_flutter_flutter-ultra-build__list_flavors` — check for flavor configuration.
 
-### 2. Add `ultra_flutter` to dev_dependencies
+### 2. Add `ultra_flutter` to dependencies
 
-- `mcp__plugin_flutter_flutter-ultra-build__pub_add` with `package: ultra_flutter`, `dev: true`.
-- If it fails (not on pub.dev), use `mcp__plugin_flutter_flutter-ultra-build__pubspec_overrides_set` to point to the bundled path, add `ultra_flutter: any` under `dev_dependencies` manually, then `mcp__plugin_flutter_flutter-ultra-build__pub_get`.
+- `mcp__plugin_flutter_flutter-ultra-build__pub_add` with `package: ultra_flutter` (NOT dev — it runs in the app process, guarded by `kDebugMode`).
+- If it fails (not on pub.dev), use `mcp__plugin_flutter_flutter-ultra-build__pubspec_overrides_set` to point to the bundled path, add `ultra_flutter: any` under `dependencies` manually, then `mcp__plugin_flutter_flutter-ultra-build__pub_get`.
 
 ### 3. Patch the app entry point
 
@@ -28,27 +28,43 @@ Expected end state: `UltraFlutterBinding` initialized in the app entry point, `u
 
 ```dart
 import 'package:flutter/foundation.dart';
+import 'package:flutter/widgets.dart';
 import 'package:ultra_flutter/ultra_flutter.dart';
 
 void main() {
   if (kDebugMode) {
     UltraFlutterBinding.ensureInitialized();
+  } else {
+    WidgetsFlutterBinding.ensureInitialized();
   }
   runApp(const MyApp());
 }
 ```
 
-**With Sentry** (custom binding mixin):
+**With Sentry** (composed binding class — both mixins on one binding):
 
 ```dart
+import 'package:flutter/foundation.dart';
+import 'package:flutter/widgets.dart';
+import 'package:sentry_flutter/sentry_flutter.dart';
 import 'package:ultra_flutter/ultra_flutter.dart';
 
-class AppBinding extends WidgetsFlutterBinding with UltraFlutterBindingMixin {
-  static AppBinding ensureInitialized() =>
-      WidgetsFlutterBinding.ensureInitialized() as AppBinding;
+class AppBinding extends WidgetsFlutterBinding
+    with SentryWidgetsBindingMixin, UltraFlutterBinding {}
+
+void main() async {
+  if (kDebugMode) {
+    AppBinding();
+  } else {
+    WidgetsFlutterBinding.ensureInitialized();
+  }
+  await SentryFlutter.init((options) { /* ... */ });
+  runApp(const MyApp());
 }
 ```
 
+The `on WidgetsBinding` constraint lets `UltraFlutterBinding` compose with any other mixin — Sentry, integration_test, or custom bindings. Only one binding class can exist per process, so both mixins must be on the same class.
+
 Skip if `project_info` reported `hasUltraBinding: true`.
 
 ### 4. Configure patrol fork override (if patrol detected)
@@ -130,7 +146,7 @@ User: "Set up flutter-ultra on my app."
 1. flutter_doctor -> all checks pass
 2. project_info -> entryPoints: ["lib/main.dart"], hasSentry: false, hasPatrol: false
 3. list_devices -> chrome, windows
-4. pub_add ultra_flutter dev:true -> added
+4. pub_add ultra_flutter -> added to dependencies
 5. Edit lib/main.dart -> add UltraFlutterBinding.ensureInitialized()
 6. pub_get -> resolved
 7. analyze -> 0 errors