flutter-mcp-toolkit-maintain-macos

name: flutter-mcp-toolkit-maintain-macos description: Maintains flutter_test_app macOS showcase, native intentcall hooks (codegen, app_links invoke), and VM MCP validation. Use when editing macOS Runner, intentcall_codegen.sh, macOS dogfood, Screen Recording capture, or comparing macOS parity to web WebMCP.

Maintain macOS (showcase + native intentcall)

Dogfood app: flutter_test_app. Platform doc: flutter_test_app/INTENTCALL_PLATFORM.md.

WebMCP on macOS

navigator.modelContext is web-only. macOS dogfood proves VM extensions, dynamic registry, native invoke (intentcall:// via app_links), and visual capture (Screen Recording on host).

For WebMCP parity scoring, run web iteration separately (flutter-mcp-toolkit-maintain-web).

Launch showcase

make showcase-stop && make showcase

Log: .showcase/flutter_app.log
WS URI: grep ws://127.0.0.1:…/ws from log (default VM port 8181)

grep -Eo 'ws://127\.0\.0\.1:[0-9]+/[A-Za-z0-9_=-]+/ws' .showcase/flutter_app.log | tail -1

Stop: make showcase-stop.

Codegen & hooks

dart run mcp_server_dart/bin/flutter_mcp_toolkit.dart codegen sync \
  --platform web,android,ios,macos,linux,windows \
  --project-dir flutter_test_app

dart run mcp_server_dart/bin/flutter_mcp_toolkit.dart init intentcall-platform \
  --project-dir flutter_test_app --check

Target	Role
`macos/intentcall_codegen.sh`	Xcode Run Script → `codegen sync --platform macos`
`macos/Runner.xcodeproj`	Run Script phase (see script comment if manual)
`lib/main.dart`	`IntentCallInvokeLinkListener` for `intentcall://invoke/…`

Runtime validate

dart run mcp_server_dart/bin/flutter_mcp_toolkit.dart --save-images \
  --output-dir .showcase/macos_iter validate-runtime \
  --target "$MACOS_WS_URI" \
  --flutter-device macos \
  --timeout-ms 45000

Permissions (host process running CLI):

dart run mcp_server_dart/bin/flutter_mcp_toolkit.dart permissions status
dart run mcp_server_dart/bin/flutter_mcp_toolkit.dart permissions request

Dual-platform dogfood

bash tool/evals/run_dogfood_eval.sh \
  --ws-uri "$WEB_WS_URI" \
  --macos --macos-ws-uri "$MACOS_WS_URI"

flutter-mcp-cli-runtime-validation — doctor, capture backends, extensions
flutter-mcp-toolkit-maintain-web — WebMCP enablement
flutter-mcp-toolkit-dogfood-iterations — rubric + tracker