@bdayadev/flutter-ultra-mcp 0.0.0 → 1.0.1

package/skills/_internal-on-tool-failure/SKILL.md

@@ -1,13 +1,13 @@
----
-name: _internal-on-tool-failure
-description: Internal skill invoked by the PostToolUse hook when a flutter-ultra tool returns isError. Captures structured remediation context. Not for direct user invocation.
-disable-model-invocation: true
----
-
-# Internal: On Tool Failure (stub)
-
-**Status:** scaffold stub. Implementation owner: wave-3 skills worker (see plan §12).
-
-Triggered by the `PostToolUse` hook when an `mcp__flutter-ultra-*__*` tool returns `isError: true`. Reads the failure event from `state/tool-events.jsonl`, formats a one-line remediation summary, and appends it to the conversation as a system reminder.
-
-Not advertised in the user-facing skill list.
+---
+name: _internal-on-tool-failure
+description: Internal skill invoked by the PostToolUse hook when a flutter-ultra tool returns isError. Captures structured remediation context. Not for direct user invocation.
+disable-model-invocation: true
+---
+
+# Internal: On Tool Failure (stub)
+
+**Status:** scaffold stub. Implementation owner: wave-3 skills worker (see plan §12).
+
+Triggered by the `PostToolUse` hook when an `mcp__flutter-ultra-*__*` tool returns `isError: true`. Reads the failure event from `state/tool-events.jsonl`, formats a one-line remediation summary, and appends it to the conversation as a system reminder.
+
+Not advertised in the user-facing skill list.

package/skills/_internal-session-bootstrap/SKILL.md

@@ -1,18 +1,18 @@
----
-name: _internal-session-bootstrap
-description: Internal skill invoked by the SessionStart hook to detect Flutter context and warm cached state. Not for direct user invocation.
-disable-model-invocation: true
----
-
-# Internal: Session Bootstrap (stub)
-
-**Status:** scaffold stub. Implementation owner: wave-3 skills worker (see plan §12).
-
-Triggered by the `SessionStart` hook. Performs:
-
-- Project root detection (`pubspec.yaml` walk)
-- Cached session discovery refresh
-- Plugin-doctor self-check
-- Initial telemetry frame written to `state/tool-events.jsonl`
-
-Not advertised in the user-facing skill list.
+---
+name: _internal-session-bootstrap
+description: Internal skill invoked by the SessionStart hook to detect Flutter context and warm cached state. Not for direct user invocation.
+disable-model-invocation: true
+---
+
+# Internal: Session Bootstrap (stub)
+
+**Status:** scaffold stub. Implementation owner: wave-3 skills worker (see plan §12).
+
+Triggered by the `SessionStart` hook. Performs:
+
+- Project root detection (`pubspec.yaml` walk)
+- Cached session discovery refresh
+- Plugin-doctor self-check
+- Initial telemetry frame written to `state/tool-events.jsonl`
+
+Not advertised in the user-facing skill list.

package/skills/debug/SKILL.md

@@ -1,20 +1,20 @@
----
-name: debug
-description: Attaching to a running Flutter app and triaging an error from the stack trace, widget tree, render tree, and recent screenshot. Use when the user reports a runtime exception, layout overflow, or unexpected behaviour and you need to inspect live state.
----
-
-# Debug (stub)
-
-**Status:** scaffold stub. Implementation owner: wave-3 skills worker (see plan §8.3, §12).
-
-## Workflow
-
-- `mcp__flutter-ultra-runtime__discover_sessions` and pick the target app.
-- Pull recent errors with `mcp__flutter-ultra-runtime__get_runtime_errors`.
-- Cross-reference frames with `mcp__flutter-ultra-runtime__get_widget_tree` and `dump_render_tree`.
-- Capture a screenshot for context.
-- Propose a fix inline; do not edit code unless asked.
-
-## See also
-
-- Plan §8.3
+---
+name: debug
+description: Attaching to a running Flutter app and triaging an error from the stack trace, widget tree, render tree, and recent screenshot. Use when the user reports a runtime exception, layout overflow, or unexpected behaviour and you need to inspect live state.
+---
+
+# Debug (stub)
+
+**Status:** scaffold stub. Implementation owner: wave-3 skills worker (see plan §8.3, §12).
+
+## Workflow
+
+- `mcp__flutter-ultra-runtime__discover_sessions` and pick the target app.
+- Pull recent errors with `mcp__flutter-ultra-runtime__get_runtime_errors`.
+- Cross-reference frames with `mcp__flutter-ultra-runtime__get_widget_tree` and `dump_render_tree`.
+- Capture a screenshot for context.
+- Propose a fix inline; do not edit code unless asked.
+
+## See also
+
+- Plan §8.3

package/skills/devtools/SKILL.md

@@ -1,21 +1,21 @@
----
-name: devtools
-description: Wiring up the Flutter DevTools panel for this plugin so the user can see live MCP activity inside their IDE. Use when the user wants to inspect the plugin's recent tool calls, attached sessions, or activity timeline.
-disable-model-invocation: true
----
-
-# DevTools (stub)
-
-**Status:** scaffold stub. Implementation owner: wave-3 skills worker (see plan §8.6, §12).
-
-User-triggered only — installing a dev dependency and editing pubspec is opinionated.
-
-## Workflow
-
-- Detect `ultra_flutter_devtools` in `dev_dependencies`; add via `mcp__flutter-ultra-build__pub_add` if missing.
-- Start the panel WebSocket via `mcp__flutter-ultra-devtools__start_panel_server`.
-- Print the DevTools URL with the `flutter-ultra` tab anchor.
-
-## See also
-
-- Plan §8.6, §6.2
+---
+name: devtools
+description: Wiring up the Flutter DevTools panel for this plugin so the user can see live MCP activity inside their IDE. Use when the user wants to inspect the plugin's recent tool calls, attached sessions, or activity timeline.
+disable-model-invocation: true
+---
+
+# DevTools (stub)
+
+**Status:** scaffold stub. Implementation owner: wave-3 skills worker (see plan §8.6, §12).
+
+User-triggered only — installing a dev dependency and editing pubspec is opinionated.
+
+## Workflow
+
+- Detect `ultra_flutter_devtools` in `dev_dependencies`; add via `mcp__flutter-ultra-build__pub_add` if missing.
+- Start the panel WebSocket via `mcp__flutter-ultra-devtools__start_panel_server`.
+- Print the DevTools URL with the `flutter-ultra` tab anchor.
+
+## See also
+
+- Plan §8.6, §6.2

package/skills/drive/SKILL.md

@@ -1,20 +1,20 @@
----
-name: drive
-description: Driving multi-step user flows in a running Flutter app via gestures and assertions. Use when reproducing a bug across several screens, validating an onboarding flow, or running an ad-hoc end-to-end scenario without writing a patrol test.
----
-
-# Drive (stub)
-
-**Status:** scaffold stub. Implementation owner: wave-3 skills worker (see plan §8.2, §12).
-
-## Workflow
-
-- Enumerate interactive elements via `mcp__flutter-ultra-gesture__interactive_elements`.
-- Tap or enter text using key-based finders.
-- Verify intermediate state via `mcp__flutter-ultra-runtime__get_widget_tree`.
-- For OAuth/popups: delegate to `mcp__flutter-ultra-browser__*` (web) or `mcp__flutter-ultra-native-mobile__*` (mobile).
-
-## See also
-
-- Plan §8.2
-- Sibling skill: `test` for orchestrated patrol runs
+---
+name: drive
+description: Driving multi-step user flows in a running Flutter app via gestures and assertions. Use when reproducing a bug across several screens, validating an onboarding flow, or running an ad-hoc end-to-end scenario without writing a patrol test.
+---
+
+# Drive (stub)
+
+**Status:** scaffold stub. Implementation owner: wave-3 skills worker (see plan §8.2, §12).
+
+## Workflow
+
+- Enumerate interactive elements via `mcp__flutter-ultra-gesture__interactive_elements`.
+- Tap or enter text using key-based finders.
+- Verify intermediate state via `mcp__flutter-ultra-runtime__get_widget_tree`.
+- For OAuth/popups: delegate to `mcp__flutter-ultra-browser__*` (web) or `mcp__flutter-ultra-native-mobile__*` (mobile).
+
+## See also
+
+- Plan §8.2
+- Sibling skill: `test` for orchestrated patrol runs

package/skills/scaffold/SKILL.md

@@ -1,21 +1,21 @@
----
-name: scaffold
-description: Scaffolding new Flutter projects or features following the conventions detected in the existing codebase. Use when starting a fresh app, adding a feature module, or generating boilerplate that should match an existing project's structure.
-disable-model-invocation: true
----
-
-# Scaffold (stub)
-
-**Status:** scaffold stub. Implementation owner: wave-3 skills worker (see plan §8.4, §12).
-
-This skill is opinionated and destructive (creates files), so it is **not** auto-invocable. The user must trigger it explicitly with `/flutter:scaffold`.
-
-## Workflow
-
-- Project mode: `flutter create` via shell with detected channel + org.
-- Feature mode: read the existing structure via `mcp__flutter-ultra-build__project_info`, then create files that match.
-
-## See also
-
-- Plan §8.4
-- Sibling skill: `setup` for plugging the plugin into an existing codebase
+---
+name: scaffold
+description: Scaffolding new Flutter projects or features following the conventions detected in the existing codebase. Use when starting a fresh app, adding a feature module, or generating boilerplate that should match an existing project's structure.
+disable-model-invocation: true
+---
+
+# Scaffold (stub)
+
+**Status:** scaffold stub. Implementation owner: wave-3 skills worker (see plan §8.4, §12).
+
+This skill is opinionated and destructive (creates files), so it is **not** auto-invocable. The user must trigger it explicitly with `/flutter:scaffold`.
+
+## Workflow
+
+- Project mode: `flutter create` via shell with detected channel + org.
+- Feature mode: read the existing structure via `mcp__flutter-ultra-build__project_info`, then create files that match.
+
+## See also
+
+- Plan §8.4
+- Sibling skill: `setup` for plugging the plugin into an existing codebase

package/skills/setup/SKILL.md

@@ -1,26 +1,26 @@
----
-name: setup
-description: Bootstrapping flutter-ultra-mcp into an existing Flutter codebase end-to-end. Use when the user wants the plugin enabled for the first time on a project, or when re-running after a clean install. Idempotent.
-disable-model-invocation: true
----
-
-# Setup (stub)
-
-**Status:** scaffold stub. Implementation owner: wave-3 skills worker (see plan §8.7, §12).
-
-User-triggered only — patches pubspec, entry points, and `.vscode/launch.json`.
-
-## Workflow (target)
-
-1. Detect project layout via `mcp__flutter-ultra-build__project_info` (entry points, existing bindings, Sentry usage, patrol).
-2. Add `ultra_flutter` to `dev_dependencies`; if Sentry detected, show the direct `// ignore: implementation_imports` binding pattern.
-3. Patch entry point(s) with AST-aware edits to mix in `UltraFlutterBinding` under `kDebugMode`.
-4. Optional: add a launch.json profile pre-applying dart-defines for session discovery.
-5. Detect existing patrol setup and offer the `run_patrol_web` wrapper.
-6. Generate per-project `.flutter-ultra.config.yaml`.
-7. Run a smoke launch + screenshot + detach.
-8. Emit `SETUP-REPORT.md` at project root.
-
-## See also
-
-- Plan §8.7
+---
+name: setup
+description: Bootstrapping flutter-ultra-mcp into an existing Flutter codebase end-to-end. Use when the user wants the plugin enabled for the first time on a project, or when re-running after a clean install. Idempotent.
+disable-model-invocation: true
+---
+
+# Setup (stub)
+
+**Status:** scaffold stub. Implementation owner: wave-3 skills worker (see plan §8.7, §12).
+
+User-triggered only — patches pubspec, entry points, and `.vscode/launch.json`.
+
+## Workflow (target)
+
+1. Detect project layout via `mcp__flutter-ultra-build__project_info` (entry points, existing bindings, Sentry usage, patrol).
+2. Add `ultra_flutter` to `dev_dependencies`; if Sentry detected, show the direct `// ignore: implementation_imports` binding pattern.
+3. Patch entry point(s) with AST-aware edits to mix in `UltraFlutterBinding` under `kDebugMode`.
+4. Optional: add a launch.json profile pre-applying dart-defines for session discovery.
+5. Detect existing patrol setup and offer the `run_patrol_web` wrapper.
+6. Generate per-project `.flutter-ultra.config.yaml`.
+7. Run a smoke launch + screenshot + detach.
+8. Emit `SETUP-REPORT.md` at project root.
+
+## See also
+
+- Plan §8.7

package/skills/test/SKILL.md

@@ -1,19 +1,19 @@
----
-name: test
-description: Orchestrating Flutter unit, widget, and patrol E2E tests with focused reporting. Use when the user asks to run tests, validate a fix, or check coverage on a Flutter project.
----
-
-# Test (stub)
-
-**Status:** scaffold stub. Implementation owner: wave-3 skills worker (see plan §8.5, §12).
-
-## Workflow
-
-- `mcp__flutter-ultra-build__analyze` first; fail fast on lint errors.
-- `mcp__flutter-ultra-build__run_unit_tests` / `run_widget_tests` per the input pattern.
-- `mcp__flutter-ultra-patrol__*` for E2E.
-- Report failures with file:line + a screenshot snapshot when available.
-
-## See also
-
-- Plan §8.5
+---
+name: test
+description: Orchestrating Flutter unit, widget, and patrol E2E tests with focused reporting. Use when the user asks to run tests, validate a fix, or check coverage on a Flutter project.
+---
+
+# Test (stub)
+
+**Status:** scaffold stub. Implementation owner: wave-3 skills worker (see plan §8.5, §12).
+
+## Workflow
+
+- `mcp__flutter-ultra-build__analyze` first; fail fast on lint errors.
+- `mcp__flutter-ultra-build__run_unit_tests` / `run_widget_tests` per the input pattern.
+- `mcp__flutter-ultra-patrol__*` for E2E.
+- Report failures with file:line + a screenshot snapshot when available.
+
+## See also
+
+- Plan §8.5

package/skills/tour/SKILL.md

@@ -1,22 +1,22 @@
----
-name: tour
-description: Running route-by-route screenshot tours of a Flutter app. Use when capturing visual state across many app routes, doing pre-release visual regression sweeps, or documenting a feature's UI for review.
----
-
-# Route Tour (stub)
-
-**Status:** scaffold stub. Implementation owner: wave-3 skills worker (see plan §8.1, §12).
-
-## Quick start
-
-1. Identify the active session via `mcp__flutter-ultra-runtime__discover_sessions`.
-2. For each route in the input list:
-   - Navigate (web: browser navigate, mobile/desktop: GoRouter evaluate)
-   - Wait for the root widget key
-   - Take a screenshot, save to `.omc/research/tour-<date>/<route-slug>.png`
-3. Write `tour-report.md` summarizing route to screenshot mapping.
-
-## See also
-
-- Plan §8.1
-- Sibling skill: `drive` for multi-step interaction flows
+---
+name: tour
+description: Running route-by-route screenshot tours of a Flutter app. Use when capturing visual state across many app routes, doing pre-release visual regression sweeps, or documenting a feature's UI for review.
+---
+
+# Route Tour (stub)
+
+**Status:** scaffold stub. Implementation owner: wave-3 skills worker (see plan §8.1, §12).
+
+## Quick start
+
+1. Identify the active session via `mcp__flutter-ultra-runtime__discover_sessions`.
+2. For each route in the input list:
+   - Navigate (web: browser navigate, mobile/desktop: GoRouter evaluate)
+   - Wait for the root widget key
+   - Take a screenshot, save to `.omc/research/tour-<date>/<route-slug>.png`
+3. Write `tour-report.md` summarizing route to screenshot mapping.
+
+## See also
+
+- Plan §8.1
+- Sibling skill: `drive` for multi-step interaction flows