flutter-skill 0.8.6 → 0.8.7

package/README.md

@@ -161,18 +161,91 @@ Real benchmarks from automated test runs against a complex social media app:
 
 ## Why Not Playwright / Appium / Detox?
 
-| | flutter-skill | Playwright | Appium | Detox |
+| | flutter-skill | Playwright MCP | Appium | Detox |
 |---|:---:|:---:|:---:|:---:|
+| **MCP tools** | **237** | ~33 | ❌ | ❌ |
+| **Platforms** | **10** | 1 (web) | Mobile | React Native |
 | **Setup time** | 30 sec | Minutes | Hours | Hours |
 | **Test code needed** | ❌ None | ✅ Yes | ✅ Yes | ✅ Yes |
-| **AI-native (MCP)** | ✅ | ❌ | ❌ | ❌ |
-| **Platforms** | 10 | 3 (web) | Mobile | React Native |
+| **AI-native (MCP)** | ✅ | ✅ | ❌ | ❌ |
+| **Self-healing tests** | ✅ | ❌ | ❌ | ❌ |
+| **Monkey/fuzz testing** | ✅ | ❌ | ❌ | ❌ |
+| **Visual regression** | ✅ | ❌ | ❌ | ❌ |
+| **Network mock/replay** | ✅ | ❌ | ❌ | ❌ |
+| **API + UI testing** | ✅ | ❌ | ❌ | ❌ |
+| **Multi-device sync** | ✅ | ❌ | Partial | ❌ |
+| **Accessibility audit** | ✅ | ❌ | ❌ | ❌ |
+| **i18n testing** | ✅ | ❌ | ❌ | ❌ |
+| **Performance monitoring** | ✅ | ❌ | ❌ | ❌ |
 | **Natural language** | ✅ | ❌ | ❌ | ❌ |
-| **Maintenance** | Zero | High | High | Medium |
 | **Flutter support** | ✅ Native | Partial | Partial | ❌ |
 | **Desktop apps** | ✅ | ✅ | ❌ | ❌ |
 
-**flutter-skill is the only AI-native E2E testing tool that works across mobile, web, and desktop.**
+| **AI page understanding** | ✅ AX Tree | ❌ Screenshots | ❌ | ❌ |
+| **Boundary/security test** | ✅ 13 payloads | ❌ | ❌ | ❌ |
+| **Batch actions** | ✅ 5+/call | 1/call | 1/call | 1/call |
+
+**flutter-skill is the only AI-native E2E testing tool that works across mobile, web, and desktop — with 7× more tools than the nearest competitor.**
+
+---
+
+## CLI Commands
+
+```bash
+# 🤖 AI autonomous exploration — finds bugs automatically
+flutter-skill explore https://my-app.com --depth=3
+
+# 🐒 Monkey/fuzz testing — random actions, crash detection
+flutter-skill monkey https://my-app.com --actions=100 --seed=42
+
+# 🚀 Parallel multi-platform testing
+flutter-skill test --url https://my-app.com --platforms web,electron,android
+
+# 🌐 Zero-config WebMCP server — any website becomes testable
+flutter-skill serve https://my-app.com
+```
+
+---
+
+## 🧠 AI-Native: 95% Fewer Tokens
+
+Most AI testing tools send **screenshots** to the LLM — each one costs ~4,000 tokens.
+
+flutter-skill uses Chrome's **Accessibility Tree** to give your AI a compact semantic summary of any page:
+
+```json
+// page_summary → ~200 tokens (vs ~4,000 for a screenshot)
+{
+  "title": "Shopping Cart",
+  "nav": ["Home", "Products", "Cart", "Account"],
+  "forms": [{"input:Coupon Code": "text"}],
+  "buttons": ["Apply", "Checkout", "Continue Shopping"],
+  "features": {"search": true, "pagination": true},
+  "links": 47, "inputs": 3
+}
+```
+
+Then batch multiple actions in one call:
+
+```json
+// explore_actions → 5 actions per call (vs 5 separate tool calls)
+{"actions": [
+  {"type": "fill", "target": "input:Coupon Code", "value": "SAVE20"},
+  {"type": "tap", "target": "button:Apply"},
+  {"type": "tap", "target": "button:Checkout"},
+  {"type": "fill", "target": "input:Email", "value": "test@example.com"},
+  {"type": "tap", "target": "button:Continue"}
+]}
+```
+
+**Result:** Your AI agent tests faster, costs less, and understands pages better than screenshot-based tools.
+
+| | flutter-skill | Screenshot-based tools |
+|---|:---:|:---:|
+| Tokens per page | **~200** | ~4,000 |
+| Actions per call | **5+** | 1 |
+| Understands semantics | ✅ roles, names, state | ❌ pixels only |
+| Works with Shadow DOM | ✅ | ❌ |
 
 ---
 
@@ -222,17 +295,47 @@ Real benchmarks from automated test runs against a complex social media app:
 </table>
 
 <details>
-<summary><strong>160+ tools — full reference</strong></summary>
+<summary><strong>237 tools — full reference</strong></summary>
+
+**AI Explore:** `page_summary`, `explore_actions`, `boundary_test`, `explore_report`
+
+**Launch & Connect:** `launch_app`, `scan_and_connect`, `connect_cdp`, `hot_reload`, `hot_restart`, `list_sessions`, `switch_session`, `close_session`, `disconnect`, `stop_app`
+
+**Screen:** `screenshot`, `screenshot_region`, `screenshot_element`, `native_screenshot`, `inspect`, `inspect_interactive`, `snapshot`, `get_widget_tree`, `find_by_type`, `get_text_content`, `get_visible_text`
+
+**Interaction:** `tap`, `double_tap`, `long_press`, `enter_text`, `set_text`, `clear_text`, `swipe`, `scroll_to`, `drag`, `go_back`, `press_key`, `type_text`, `hover`, `fill`, `select_option`, `set_checkbox`, `focus`, `blur`, `native_tap`, `native_input_text`, `native_swipe`
+
+**Smart Testing:** `smart_tap`, `smart_enter_text`, `smart_assert` (self-healing with fuzzy match)
+
+**Assertions:** `assert_text`, `assert_visible`, `assert_not_visible`, `assert_element_count`, `assert_batch`, `wait_for_element`, `wait_for_gone`, `wait_for_idle`, `wait_for_stable`, `wait_for_url`, `wait_for_text`, `wait_for_element_count`
+
+**Visual Regression:** `visual_baseline_save`, `visual_baseline_compare`, `visual_baseline_update`, `visual_regression_report`, `visual_verify`, `visual_diff`, `compare_screenshot`
+
+**Network Mock:** `mock_api`, `mock_clear`, `record_network`, `replay_network`, `intercept_requests`, `clear_interceptions`, `block_urls`, `http_request`
+
+**API Testing:** `api_request`, `api_assert`
+
+**Coverage & Reliability:** `coverage_start`, `coverage_stop`, `coverage_report`, `coverage_gaps`, `retry_on_fail`, `stability_check`
+
+**Data-Driven:** `test_with_data`, `generate_test_data`
+
+**Multi-Device:** `multi_connect`, `multi_action`, `multi_compare`, `multi_disconnect`, `parallel_snapshot`, `parallel_tap`
+
+**Accessibility:** `accessibility_audit`, `a11y_full_audit`, `a11y_tab_order`, `a11y_color_contrast`, `a11y_screen_reader`
+
+**i18n:** `set_locale`, `verify_translations`, `i18n_snapshot`
+
+**Performance:** `perf_start`, `perf_stop`, `perf_report`, `get_performance`, `get_frame_stats`, `get_memory_stats`
 
-**Launch & Connect:** `launch_app`, `scan_and_connect`, `hot_reload`, `hot_restart`, `list_sessions`, `switch_session`, `close_session`
+**Session:** `save_session`, `restore_session`, `session_diff`
 
-**Screen:** `screenshot`, `screenshot_region`, `screenshot_element`, `native_screenshot`, `inspect`, `inspect_interactive`, `get_widget_tree`, `find_by_type`, `get_text_content`
+**Recording & Export:** `record_start`, `record_stop`, `record_export` (Playwright, Cypress, XCUITest, Espresso, Detox, Maestro, +5 more), `video_start`, `video_stop`
 
-**Interaction:** `tap`, `double_tap`, `long_press`, `enter_text`, `set_text`, `clear_text`, `swipe`, `scroll_to`, `drag`, `go_back`, `press_key`, `native_tap`, `native_input_text`, `native_swipe`
+**Auth:** `auth_inject_session`, `auth_biometric`, `auth_otp`, `auth_deeplink`
 
-**Assertions:** `assert_text`, `assert_visible`, `assert_not_visible`, `assert_element_count`, `wait_for_element`, `wait_for_gone`, `get_checkbox_state`, `get_slider_value`, `get_text_value`
+**CDP Browser:** `navigate`, `reload`, `go_forward`, `get_title`, `get_page_source`, `eval`, `get_tabs`, `new_tab`, `switch_tab`, `close_tab`, `get_cookies`, `set_cookie`, `clear_cookies`, `get_local_storage`, `set_local_storage`, `clear_local_storage`, `generate_pdf`, `set_viewport`, `emulate_device`, `throttle_network`, `go_offline`, `set_geolocation`, `set_timezone`, `set_color_scheme`
 
-**Debug:** `get_logs`, `get_errors`, `get_performance`, `get_memory_stats`
+**Debug:** `get_logs`, `get_errors`, `get_console_messages`, `get_network_requests`, `diagnose`, `diagnose_project`, `reset_app`
 
 </details>
 

package/dart/pubspec.yaml

@@ -1,6 +1,6 @@
 name: flutter_skill_npm
 description: Give your AI Agent eyes and hands inside your Flutter app.
-version: 0.8.6
+version: 0.8.7
 publish_to: 'none'
 homepage: https://github.com/ai-dashboad/flutter-skill
 repository: https://github.com/ai-dashboad/flutter-skill

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "flutter-skill",
   "mcpName": "io.github.ai-dashboad/flutter-skill",
-  "version": "0.8.6",
+  "version": "0.8.7",
   "description": "MCP Server for app automation - Give your AI Agent eyes and hands inside any app (Flutter, React, Web, Native)",
   "main": "index.js",
   "bin": {