@bdayadev/flutter-ultra-mcp 1.16.0 → 1.16.2

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.16.0",
+      "version": "1.16.2",
       "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.16.0"
+  "version": "1.16.2"
 }

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "flutter",
-  "version": "1.16.0",
+  "version": "1.16.2",
   "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/pubspec.yaml

@@ -4,7 +4,7 @@ description: >-
   extensions (gesture, screenshot, inspector, screencast, log collection)
   for the flutter-ultra-mcp Claude Code plugin. Composable with Sentry and
   other WidgetsFlutterBinding subclasses via the mixin form.
-version: 1.16.0
+version: 1.16.2
 homepage: https://github.com/Bdaya-Dev/flutter-ultra-mcp
 repository: https://github.com/Bdaya-Dev/flutter-ultra-mcp
 issue_tracker: https://github.com/Bdaya-Dev/flutter-ultra-mcp/issues

package/dart/ultra_flutter_devtools/pubspec.yaml

@@ -2,7 +2,7 @@ name: ultra_flutter_devtools
 description: >-
   Flutter DevTools extension showing live MCP activity for the flutter-ultra-mcp
   Claude Code plugin (sessions, recent tool calls, errors, screenshot grid).
-version: 1.16.0
+version: 1.16.2
 homepage: https://github.com/Bdaya-Dev/flutter-ultra-mcp
 repository: https://github.com/Bdaya-Dev/flutter-ultra-mcp
 issue_tracker: https://github.com/Bdaya-Dev/flutter-ultra-mcp/issues

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bdayadev/flutter-ultra-mcp",
-  "version": "1.16.0",
+  "version": "1.16.2",
   "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",
@@ -63,6 +63,7 @@
   "files": [
     ".claude-plugin/",
     ".mcp.json",
+    "scripts/ensure-plugin-deps.js",
     "skills/",
     "packages/*/dist/",
     "packages/*/package.json",

package/scripts/ensure-plugin-deps.js

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+// Ensures production dependencies (playwright-core) are installed in
+// CLAUDE_PLUGIN_DATA. Strips workspaces/devDependencies from the copied
+// package.json so npm install works in a flat directory.
+const fs = require('node:fs');
+const path = require('node:path');
+const { execSync } = require('node:child_process');
+
+const pluginRoot = process.env.CLAUDE_PLUGIN_ROOT;
+const pluginData = process.env.CLAUDE_PLUGIN_DATA;
+if (!pluginRoot || !pluginData) {
+  process.exit(0);
+}
+
+const srcPkg = JSON.parse(fs.readFileSync(path.join(pluginRoot, 'package.json'), 'utf8'));
+const cleaned = {
+  name: srcPkg.name,
+  version: srcPkg.version,
+  dependencies: srcPkg.dependencies || {},
+};
+const cleanedStr = JSON.stringify(cleaned, null, 2) + '\n';
+
+const dstPath = path.join(pluginData, 'package.json');
+try {
+  if (fs.readFileSync(dstPath, 'utf8') === cleanedStr) {
+    const nmExists = fs.existsSync(path.join(pluginData, 'node_modules', 'playwright-core'));
+    if (nmExists) process.exit(0);
+  }
+} catch {}
+
+fs.writeFileSync(dstPath, cleanedStr);
+try {
+  execSync('npm install --production --no-audit --no-fund', {
+    cwd: pluginData,
+    stdio: 'inherit',
+    timeout: 90_000,
+  });
+} catch {
+  fs.unlinkSync(dstPath);
+  process.exit(1);
+}

package/skills/bisect/SKILL.md

@@ -116,6 +116,7 @@ git stash pop  # if stash was created
 | List projects        | `mcp__plugin_flutter_flutter-ultra-build__list_projects`               |
 | Pub get              | `mcp__plugin_flutter_flutter-ultra-build__pub_get`                     |
 | Flutter clean        | `mcp__plugin_flutter_flutter-ultra-build__flutter_clean`               |
+| Static analysis      | `mcp__plugin_flutter_flutter-ultra-build__analyze`                     |
 | Build runner start   | `mcp__plugin_flutter_flutter-ultra-build__start_build_runner_build`    |
 | Build runner poll    | `mcp__plugin_flutter_flutter-ultra-build__poll_build_runner_job`       |
 | Build runner result  | `mcp__plugin_flutter_flutter-ultra-build__get_build_runner_result`     |
@@ -131,6 +132,7 @@ git stash pop  # if stash was created
 | Start patrol test    | `mcp__plugin_flutter_flutter-ultra-patrol__start_patrol_test`          |
 | Poll patrol          | `mcp__plugin_flutter_flutter-ultra-patrol__poll_patrol_job`            |
 | Get patrol result    | `mcp__plugin_flutter_flutter-ultra-patrol__get_patrol_result`          |
+| Hot restart          | `mcp__plugin_flutter_flutter-ultra-runtime__hot_restart`               |
 | Build (any platform) | `start_build_{platform}` via the build server                          |
 
 ## Output format

package/skills/debug/SKILL.md

@@ -121,13 +121,40 @@ Use this when `evaluate` and `get_runtime_errors` are insufficient to explain ob
 - `context.read<MyBloc>().state.toString()`
 - `ProviderScope.containerOf(context).read(myProvider).toString()`
 
-### 7. Test the fix
+### 7. Static analysis and auto-fix
+
+When the runtime triage points to a code-level issue:
+
+- `mcp__plugin_flutter_flutter-ultra-build__analyze` — run static analysis to surface type errors, lint violations, and deprecation warnings related to the bug.
+- `mcp__plugin_flutter_flutter-ultra-build__fix_preview` — preview automated fixes before applying.
+- `mcp__plugin_flutter_flutter-ultra-build__fix` — apply safe automated fixes (`dart fix --apply`).
+
+### 8. IDE-level code navigation
+
+Use LSP tools for pinpoint navigation when reading unfamiliar call paths:
+
+- `mcp__plugin_oh-my-claudecode_t__lsp_hover` (`dart_hover`) — inspect the type, docs, and inferred value of any expression at a given file:line:col without running the app.
+- `mcp__plugin_oh-my-claudecode_t__lsp_goto_definition` (`dart_go_to_definition`) — jump to the declaration of the method or class under the cursor.
+- `mcp__plugin_oh-my-claudecode_t__lsp_document_symbols` (`get_active_location`) — list all symbols in the current file to map the class/method structure quickly.
+
+### 9. Test the fix
 
 1. Apply the code change.
 2. `mcp__plugin_flutter_flutter-ultra-runtime__hot_reload` (or `mcp__plugin_flutter_flutter-ultra-runtime__hot_restart` if `initState` changed).
 3. Re-run the appropriate triage step to confirm the error is gone.
 4. `mcp__plugin_flutter_flutter-ultra-runtime__screenshot` for before/after comparison.
 
+## Build and LSP tool reference
+
+| Action                    | Tool                                                              |
+| ------------------------- | ----------------------------------------------------------------- |
+| Static analysis           | `mcp__plugin_flutter_flutter-ultra-build__analyze`                |
+| Preview auto-fixes        | `mcp__plugin_flutter_flutter-ultra-build__fix_preview`            |
+| Apply auto-fixes          | `mcp__plugin_flutter_flutter-ultra-build__fix`                    |
+| Hover type/docs           | `mcp__plugin_oh-my-claudecode_t__lsp_hover`                       |
+| Go to definition          | `mcp__plugin_oh-my-claudecode_t__lsp_goto_definition`             |
+| List file symbols         | `mcp__plugin_oh-my-claudecode_t__lsp_document_symbols`            |
+
 ## Common patterns
 
 | Symptom                                  | First tool                                    | What to look for                         |

package/skills/design-audit/SKILL.md

@@ -184,6 +184,25 @@ Produce a markdown report with the following sections:
 | Tiny text              | Increase to ≥ 12 dp, or use `textTheme.labelSmall` (14 dp minimum by M3 spec)               |
 | Inconsistent spacing   | Use `const EdgeInsets.all(8)` / `16` / `24` — multiples of 4                                |
 
+## Tool reference
+
+| Action                    | Tool                                                                        |
+| ------------------------- | --------------------------------------------------------------------------- |
+| Attach                    | `mcp__plugin_flutter_flutter-ultra-runtime__attach`                         |
+| Screenshot                | `mcp__plugin_flutter_flutter-ultra-runtime__screenshot`                     |
+| Full design audit         | `mcp__plugin_flutter_flutter-ultra-runtime__audit_design`                   |
+| Responsive audit          | `mcp__plugin_flutter_flutter-ultra-runtime__audit_responsive`               |
+| Extract design tokens     | `mcp__plugin_flutter_flutter-ultra-runtime__extract_design_tokens`          |
+| Extract component inventory | `mcp__plugin_flutter_flutter-ultra-runtime__extract_component_inventory`  |
+| Widget tree               | `mcp__plugin_flutter_flutter-ultra-runtime__get_widget_tree`                |
+| Find widget               | `mcp__plugin_flutter_flutter-ultra-runtime__find_widget`                    |
+| Widget details            | `mcp__plugin_flutter_flutter-ultra-runtime__get_widget_details`             |
+| Count tree nodes          | `mcp__plugin_flutter_flutter-ultra-runtime__count_widget_tree_nodes`        |
+| Dump render tree          | `mcp__plugin_flutter_flutter-ultra-runtime__dump_render_tree`               |
+| Dump semantics tree       | `mcp__plugin_flutter_flutter-ultra-runtime__dump_semantics_tree`            |
+| Toggle debug paint        | `mcp__plugin_flutter_flutter-ultra-runtime__toggle_debug_paint`             |
+| Evaluate expression       | `mcp__plugin_flutter_flutter-ultra-runtime__evaluate`                       |
+
 ## See also
 
 - `flutter-debug` — triage runtime exceptions and layout overflows in detail

package/skills/devtools/SKILL.md

@@ -87,21 +87,22 @@ Useful during:
 
 ## Tool reference
 
-| Action           | Tool                                                             |
-| ---------------- | ---------------------------------------------------------------- |
-| Start server     | `mcp__plugin_flutter_flutter-ultra-devtools__start_panel_server` |
-| Stop server      | `mcp__plugin_flutter_flutter-ultra-devtools__stop_panel_server`  |
-| Check status     | `mcp__plugin_flutter_flutter-ultra-devtools__panel_status`       |
-| Push event       | `mcp__plugin_flutter_flutter-ultra-devtools__push_event`         |
-| Wait for command | `mcp__plugin_flutter_flutter-ultra-devtools__panel_command`      |
-| Project info     | `mcp__plugin_flutter_flutter-ultra-build__project_info`          |
-| Add dependency   | `mcp__plugin_flutter_flutter-ultra-build__pub_add`               |
-| Resolve deps     | `mcp__plugin_flutter_flutter-ultra-build__pub_get`               |
-| Overrides set    | `mcp__plugin_flutter_flutter-ultra-build__pubspec_overrides_set` |
-| VM screenshot    | `mcp__plugin_flutter_flutter-ultra-runtime__screenshot`          |
-| Runtime errors   | `mcp__plugin_flutter_flutter-ultra-runtime__get_runtime_errors`  |
-| Gesture tap      | `mcp__plugin_flutter_flutter-ultra-gesture__tap`                 |
-| Patrol result    | `mcp__plugin_flutter_flutter-ultra-patrol__get_patrol_result`    |
+| Action           | Tool                                                                  |
+| ---------------- | --------------------------------------------------------------------- |
+| Start server     | `mcp__plugin_flutter_flutter-ultra-devtools__start_panel_server`      |
+| Stop server      | `mcp__plugin_flutter_flutter-ultra-devtools__stop_panel_server`       |
+| Check status     | `mcp__plugin_flutter_flutter-ultra-devtools__panel_status`            |
+| Push event       | `mcp__plugin_flutter_flutter-ultra-devtools__push_event`              |
+| Wait for command | `mcp__plugin_flutter_flutter-ultra-devtools__panel_command`           |
+| Dump diagnostics | `mcp__plugin_flutter_flutter-ultra-devtools__dump_diagnostics`        |
+| Project info     | `mcp__plugin_flutter_flutter-ultra-build__project_info`               |
+| Add dependency   | `mcp__plugin_flutter_flutter-ultra-build__pub_add`                    |
+| Resolve deps     | `mcp__plugin_flutter_flutter-ultra-build__pub_get`                    |
+| Overrides set    | `mcp__plugin_flutter_flutter-ultra-build__pubspec_overrides_set`      |
+| VM screenshot    | `mcp__plugin_flutter_flutter-ultra-runtime__screenshot`               |
+| Runtime errors   | `mcp__plugin_flutter_flutter-ultra-runtime__get_runtime_errors`       |
+| Gesture tap      | `mcp__plugin_flutter_flutter-ultra-gesture__tap`                      |
+| Patrol result    | `mcp__plugin_flutter_flutter-ultra-patrol__get_patrol_result`         |
 
 ## Event types reference
 

package/skills/drive/SKILL.md

@@ -42,6 +42,8 @@ Break the user's request into discrete, verifiable steps. Announce the plan befo
 | Swipe gesture             | `mcp__plugin_flutter_flutter-ultra-gesture__swipe`                     |
 | Pinch zoom                | `mcp__plugin_flutter_flutter-ultra-gesture__pinch_zoom`                |
 | Drag and drop             | `mcp__plugin_flutter_flutter-ultra-browser__drag`                      |
+| Press key                 | `mcp__plugin_flutter_flutter-ultra-browser__press_key`                 |
+| Handle dialog             | `mcp__plugin_flutter_flutter-ultra-browser__handle_dialog`             |
 | Multi-touch gesture       | `mcp__plugin_flutter_flutter-ultra-gesture__perform_actions`           |
 | Open deep link            | `mcp__plugin_flutter_flutter-ultra-native-mobile__dispatch_deep_link`  |
 | Set location              | `mcp__plugin_flutter_flutter-ultra-native-mobile__set_device_location` |

package/skills/record-demo/SKILL.md

@@ -152,6 +152,42 @@ Return the output file path, size in bytes, and format. Suggest next steps:
 - Upload MP4 as a GitHub release asset
 - Use WebM in `<video>` tags on web landing pages
 
+### Patrol-based recording (integration tests)
+
+When the demo needs to follow a reproducible patrol integration test script:
+
+1. `mcp__plugin_flutter_flutter-ultra-patrol__start_patrol_recording` — start video capture tied to the patrol test runner.
+2. `mcp__plugin_flutter_flutter-ultra-patrol__start_patrol_test` with the target test file.
+3. `mcp__plugin_flutter_flutter-ultra-patrol__poll_patrol_job` until complete.
+4. `mcp__plugin_flutter_flutter-ultra-patrol__stop_patrol_recording` — finalize the recording.
+5. `mcp__plugin_flutter_flutter-ultra-patrol__extract_video_frame` — pull a specific frame for thumbnail or analysis.
+6. `mcp__plugin_flutter_flutter-ultra-build__convert_recording` — convert the output to GIF/MP4/WebM.
+
+Use this path when the demo must exactly match a test scenario for reproducibility.
+
+## Tool reference
+
+| Action                      | Tool                                                                        |
+| --------------------------- | --------------------------------------------------------------------------- |
+| Discover sessions           | `mcp__plugin_flutter_flutter-ultra-runtime__discover_sessions`              |
+| Runtime evaluate            | `mcp__plugin_flutter_flutter-ultra-runtime__evaluate`                       |
+| Find widget                 | `mcp__plugin_flutter_flutter-ultra-runtime__find_widget`                    |
+| Hot reload                  | `mcp__plugin_flutter_flutter-ultra-runtime__hot_reload`                     |
+| Browser new context         | `mcp__plugin_flutter_flutter-ultra-browser__new_context`                    |
+| Browser screenshot          | `mcp__plugin_flutter_flutter-ultra-browser__screenshot`                     |
+| Browser navigate            | `mcp__plugin_flutter_flutter-ultra-browser__navigate`                       |
+| Browser click               | `mcp__plugin_flutter_flutter-ultra-browser__click`                          |
+| Browser fill                | `mcp__plugin_flutter_flutter-ultra-browser__fill`                           |
+| Browser start tracing       | `mcp__plugin_flutter_flutter-ultra-browser__start_tracing`                  |
+| Browser stop tracing        | `mcp__plugin_flutter_flutter-ultra-browser__stop_tracing`                   |
+| Browser close context       | `mcp__plugin_flutter_flutter-ultra-browser__close_context`                  |
+| Patrol start recording      | `mcp__plugin_flutter_flutter-ultra-patrol__start_patrol_recording`          |
+| Patrol stop recording       | `mcp__plugin_flutter_flutter-ultra-patrol__stop_patrol_recording`           |
+| Patrol start test           | `mcp__plugin_flutter_flutter-ultra-patrol__start_patrol_test`               |
+| Patrol poll                 | `mcp__plugin_flutter_flutter-ultra-patrol__poll_patrol_job`                 |
+| Patrol extract frame        | `mcp__plugin_flutter_flutter-ultra-patrol__extract_video_frame`             |
+| Convert recording           | `mcp__plugin_flutter_flutter-ultra-build__convert_recording`                |
+
 ## Notes
 
 - ffmpeg must be installed for `convert_recording`. If not found, the tool returns a clear installation hint.

package/skills/test/SKILL.md

@@ -140,6 +140,10 @@ Got: InvoiceListLoaded with 0 items
 | Start widget tests | `mcp__plugin_flutter_flutter-ultra-build__start_run_widget_tests`        |
 | Start golden tests | `mcp__plugin_flutter_flutter-ultra-build__start_run_golden_tests`        |
 | Update goldens     | `mcp__plugin_flutter_flutter-ultra-build__start_update_goldens`          |
+| Start integ tests  | `mcp__plugin_flutter_flutter-ultra-build__start_run_integration_tests`   |
+| Poll integ tests   | `mcp__plugin_flutter_flutter-ultra-build__poll_run_integration_tests`    |
+| Get integ results  | `mcp__plugin_flutter_flutter-ultra-build__get_run_integration_tests_result` |
+| Cancel integ tests | `mcp__plugin_flutter_flutter-ultra-build__cancel_run_integration_tests`  |
 | List patrol tests  | `mcp__plugin_flutter_flutter-ultra-patrol__list_tests`                   |
 | Start patrol test  | `mcp__plugin_flutter_flutter-ultra-patrol__start_patrol_test`            |
 | Poll patrol        | `mcp__plugin_flutter_flutter-ultra-patrol__poll_patrol_job`              |

package/skills/tour/SKILL.md

@@ -92,15 +92,26 @@ Write `tour-report.md` with a markdown table of all routes, screenshot paths, an
 | Attach                 | `mcp__plugin_flutter_flutter-ultra-runtime__attach`                       |
 | Evaluate Dart          | `mcp__plugin_flutter_flutter-ultra-runtime__evaluate`                     |
 | VM screenshot          | `mcp__plugin_flutter_flutter-ultra-runtime__screenshot`                   |
+| Widget tree            | `mcp__plugin_flutter_flutter-ultra-runtime__get_widget_tree`              |
 | Find widget            | `mcp__plugin_flutter_flutter-ultra-runtime__find_widget`                  |
 | Widget exists          | `mcp__plugin_flutter_flutter-ultra-runtime__widget_exists`                |
 | Platform override      | `mcp__plugin_flutter_flutter-ultra-runtime__set_platform_override`        |
 | Runtime errors         | `mcp__plugin_flutter_flutter-ultra-runtime__get_runtime_errors`           |
+| Tap element            | `mcp__plugin_flutter_flutter-ultra-gesture__tap`                          |
+| Swipe gesture          | `mcp__plugin_flutter_flutter-ultra-gesture__swipe`                        |
+| Scroll to element      | `mcp__plugin_flutter_flutter-ultra-gesture__scroll_to`                    |
+| Enter text             | `mcp__plugin_flutter_flutter-ultra-gesture__enter_text`                   |
+| Multi-touch actions    | `mcp__plugin_flutter_flutter-ultra-gesture__perform_actions`              |
 | Wait for settle        | `mcp__plugin_flutter_flutter-ultra-gesture__wait_for`                     |
 | Responsive shots       | `mcp__plugin_flutter_flutter-ultra-gesture__take_responsive_screenshots`  |
 | Screencast start       | `mcp__plugin_flutter_flutter-ultra-gesture__start_screencast`             |
 | Screencast stop        | `mcp__plugin_flutter_flutter-ultra-gesture__stop_screencast`              |
 | Browser screenshot     | `mcp__plugin_flutter_flutter-ultra-browser__screenshot`                   |
+| Browser navigate       | `mcp__plugin_flutter_flutter-ultra-browser__navigate`                     |
+| Browser click          | `mcp__plugin_flutter_flutter-ultra-browser__click`                        |
+| Browser fill           | `mcp__plugin_flutter_flutter-ultra-browser__fill`                         |
+| Browser press key      | `mcp__plugin_flutter_flutter-ultra-browser__press_key`                    |
+| Browser wait for URL   | `mcp__plugin_flutter_flutter-ultra-browser__wait_for_url`                 |
 | Browser launch         | `mcp__plugin_flutter_flutter-ultra-browser__launch_browser`               |
 | Connect CDP            | `mcp__plugin_flutter_flutter-ultra-browser__connect_over_cdp`             |
 | Device screenshot      | `mcp__plugin_flutter_flutter-ultra-native-mobile__take_device_screenshot` |