Name: flutter-test
Author: zero3041

Prompt file imported from zero3041/PREP (.claude/commands/commands/flutter-test.md). Copyright stays with the author.

Flutter Test

This command runs the Flutter test suite and reports results. When failures occur, it diagnoses and fixes issues incrementally.

What This Command Does

Run Tests: Execute flutter test (or scope to changed files)
Parse Failures: Identify failing tests by type and cause
Fix Incrementally: One failure at a time where possible
Verify: Re-run after each fix
Report: Show coverage summary and remaining failures

When to Use

Use /flutter-test when:

After implementing a feature to verify nothing broke
After running /flutter-build to ensure tests pass
To check test coverage on new code
When a specific test file is failing
Before submitting a PR

Commands Run

# Run all tests
flutter test 2>&1

# Run with coverage
flutter test --coverage 2>&1

# Run specific test file
flutter test test/unit/domain/usecases/get_user_test.dart 2>&1

# Run tests matching a name pattern
flutter test --name "CartBloc" 2>&1

# Run integration tests (requires device/emulator)
flutter test integration_test/ 2>&1

# Update golden files when intentional visual changes are made
flutter test --update-goldens 2>&1

Example Session

User: /flutter-test

Agent:
# Flutter Test Run

## Test Execution

```
$ flutter test
00:05 +42 -2: Some tests failed.

FAILED: test/unit/data/user_repository_test.dart
  UserRepository getById
    returns null when user not found
    Expected: null
    Actual: User(id: 'test-id', name: 'Test User')

FAILED: test/widget/cart_page_test.dart
  CartPage
    shows empty state when cart is empty
    Expected: exactly one widget with text 'Your cart is empty'
    Found: no widget with text 'Your cart is empty'
```

## Fix 1: Repository Test

File: test/unit/data/user_repository_test.dart
Failure: `getById` returns a user when it should return null for missing ID

Root cause: Test setup adds a user with ID 'test-id' but queries with 'missing-id'.
Fix: Updated test to query with 'missing-id' — setup was correct, query was wrong.

```
$ flutter test test/unit/data/user_repository_test.dart
1 test passed.
```

## Fix 2: Widget Test

File: test/widget/cart_page_test.dart
Failure: Empty state text widget not found

Root cause: Empty state message was renamed from 'Your cart is empty' to 'Cart is empty' in the widget.
Fix: Updated test string to match current widget copy.

```
$ flutter test test/widget/cart_page_test.dart
1 test passed.
```

## Final Run

```
$ flutter test --coverage
All 44 tests passed.
Coverage: 84.2% (target: 80%)
```

## Summary

| Metric | Value |
|--------|-------|
| Total tests | 44 |
| Passed | 44 |
| Failed | 0 |
| Coverage | 84.2% |

Test Status: PASS ✓

Common Test Failures

Failure	Typical Fix
`Expected: <X> Actual: <Y>`	Update assertion or fix implementation
`Widget not found`	Fix finder selector or update test after widget rename
`Golden file not found`	Run `flutter test --update-goldens` to generate
`Golden mismatch`	Inspect diff; run `--update-goldens` if change was intentional
`MissingPluginException`	Mock platform channel in test setup
`LateInitializationError`	Initialize `late` fields in `setUp()`
`pumpAndSettle timed out`	Replace with explicit `pump(Duration)` calls

Related Commands

/flutter-build — Fix build errors before running tests
/flutter-review — Review code after tests pass
/tdd — Test-driven development workflow

Agent: agents/flutter-reviewer.md
Agent: agents/dart-build-resolver.md
Skill: skills/flutter-dart-code-review/
Rules: rules/dart/testing.md

Install flutter-test and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

# Flutter Test This command runs the Flutter test suite and reports results. When failures occur, it diagnoses and fixes issues incrementally. ## What This Command Does 1. **Run Tests**: Execute `flutter test` (or scope to changed files) 2. **Parse Failures**: Identify failing tests by type and cause 3. **Fix Incrementally**: One failure at a time where possible 4. **Verify**: Re-run after each fix 5. **Report**: Show coverage summary and remaining failures ## When to Use Use `/flutter-test` when: - After implementing a feature to verify nothing broke - After running `/flutter-build` to ensure tests pass - To check test coverage on new code - When a specific test file is failing - Before submitting a PR ## Commands Run ```bash # Run all tests flutter test 2>&1 # Run with coverage flutter test --coverage 2>&1 # Run specific test file flutter test test/unit/domain/usecases/get_user_test.dart 2>&1 # Run tests matching a name pattern flutter test --name "CartBloc" 2>&1 # Run integration tests (requires device/emulator) flutter test integration_test/ 2>&1 # Update golden files when intentional visual changes are made flutter test --update-goldens 2>&1 ``` ## Example Session ````text User: /flutter-test Agent: # Flutter Test Run ## Test Execution ``` $ flutter test 00:05 +42 -2: Some tests failed. FAILED: test/unit/data/user_repository_test.dart UserRepository getById returns null when user not found Expected: null Actual: User(id: 'test-id', name: 'Test User') FAILED: test/widget/cart_page_test.dart CartPage shows empty state when cart is empty Expected: exactly one widget with text 'Your cart is empty' Found: no widget with text 'Your cart is empty' ``` ## Fix 1: Repository Test File: test/unit/data/user_repository_test.dart Failure: `getById` returns a user when it should return null for missing ID Root cause: Test setup adds a user with ID 'test-id' but queries with 'missing-id'. Fix: Updated test to query with 'missing-id' — setup was correct, query was wrong. ``` $ flutter test test/unit/data/user_repository_test.dart 1 test passed. ``` ## Fix 2: Widget Test File: test/widget/cart_page_test.dart Failure: Empty state text widget not found Root cause: Empty state message was renamed from 'Your cart is empty' to 'Cart is empty' in the widget. Fix: Updated test string to match current widget copy. ``` $ flutter test test/widget/cart_page_test.dart 1 test passed. ``` ## Final Run ``` $ flutter test --coverage All 44 tests passed. Coverage: 84.2% (target: 80%) ``` ## Summary | Metric | Value | |--------|-------| | Total tests | 44 | | Passed | 44 | | Failed | 0 | | Coverage | 84.2% | Test Status: PASS ✓ ```` ## Common Test Failures | Failure | Typical Fix | |---------|-------------| | `Expected: <X> Actual: <Y>` | Update assertion or fix implementation | | `Widget not found` | Fix finder selector or update test after widget rename | | `Golden file not found` | Run `flutter test --update-goldens` to generate | | `Golden mismatch` | Inspect diff; run `--update-goldens` if change was intentional | | `MissingPluginException` | Mock platform channel in test setup | | `LateInitializationError` | Initialize `late` fields in `setUp()` | | `pumpAndSettle timed out` | Replace with explicit `pump(Duration)` calls | ## Related Commands - `/flutter-build` — Fix build errors before running tests - `/flutter-review` — Review code after tests pass - `/tdd` — Test-driven development workflow ## Related - Agent: `agents/flutter-reviewer.md` - Agent: `agents/dart-build-resolver.md` - Skill: `skills/flutter-dart-code-review/` - Rules: `rules/dart/testing.md`

{ "prompt": "# Flutter Test\n\nThis command runs the Flutter test suite and reports results. When failures occur, it diagnoses and fixes issues incrementally.\n\n## What This Command Does\n\n1. **Run Tests**: Execute `flutter test` (or scope to changed files)\n2. **Parse Failures**: Identify failing tests by type and cause\n3. **Fix Incrementally**: One failure at a time where possible\n4. **Verify**: Re-run after each fix\n5. **Report**: Show coverage summary and remaining failures\n\n## When to Use\n\nUse `/flutter-test` when:\n- After implementing a feature to verify nothing broke\n- After running `/flutter-build` to ensure tests pass\n- To check test coverage on new code\n- When a specific test file is failing\n- Before submitting a PR\n\n## Commands Run\n\n```bash\n# Run all tests\nflutter test 2>&1\n\n# Run with coverage\nflutter test --coverage 2>&1\n\n# Run specific test file\nflutter test test/unit/domain/usecases/get_user_test.dart 2>&1\n\n# Run tests matching a name pattern\nflutter test --name \"CartBloc\" 2>&1\n\n# Run integration tests (requires device/emulator)\nflutter test integration_test/ 2>&1\n\n# Update golden files when intentional visual changes are made\nflutter test --update-goldens 2>&1\n```\n\n## Example Session\n\n````text\nUser: /flutter-test\n\nAgent:\n# Flutter Test Run\n\n## Test Execution\n\n```\n$ flutter test\n00:05 +42 -2: Some tests failed.\n\nFAILED: test/unit/data/user_repository_test.dart\n UserRepository getById\n returns null when user not found\n Expected: null\n Actual: User(id: 'test-id', name: 'Test User')\n\nFAILED: test/widget/cart_page_test.dart\n CartPage\n shows empty state when cart is empty\n Expected: exactly one widget with text 'Your cart is empty'\n Found: no widget with text 'Your cart is empty'\n```\n\n## Fix 1: Repository Test\n\nFile: test/unit/data/user_repository_test.dart\nFailure: `getById` returns a user when it should return null for missing ID\n\nRoot cause: Test setup adds a user with ID 'test-id' but queries with 'missing-id'.\nFix: Updated test to query with 'missing-id' — setup was correct, query was wrong.\n\n```\n$ flutter test test/unit/data/user_repository_test.dart\n1 test passed.\n```\n\n## Fix 2: Widget Test\n\nFile: test/widget/cart_page_test.dart\nFailure: Empty state text widget not found\n\nRoot cause: Empty state message was renamed from 'Your cart is empty' to 'Cart is empty' in the widget.\nFix: Updated test string to match current widget copy.\n\n```\n$ flutter test test/widget/cart_page_test.dart\n1 test passed.\n```\n\n## Final Run\n\n```\n$ flutter test --coverage\nAll 44 tests passed.\nCoverage: 84.2% (target: 80%)\n```\n\n## Summary\n\n| Metric | Value |\n|--------|-------|\n| Total tests | 44 |\n| Passed | 44 |\n| Failed | 0 |\n| Coverage | 84.2% |\n\nTest Status: PASS ✓\n````\n\n## Common Test Failures\n\n| Failure | Typical Fix |\n|---------|-------------|\n| `Expected: <X> Actual: <Y>` | Update assertion or fix implementation |\n| `Widget not found` | Fix finder selector or update test after widget rename |\n| `Golden file not found` | Run `flutter test --update-goldens` to generate |\n| `Golden mismatch` | Inspect diff; run `--update-goldens` if change was intentional |\n| `MissingPluginException` | Mock platform channel in test setup |\n| `LateInitializationError` | Initialize `late` fields in `setUp()` |\n| `pumpAndSettle timed out` | Replace with explicit `pump(Duration)` calls |\n\n## Related Commands\n\n- `/flutter-build` — Fix build errors before running tests\n- `/flutter-review` — Review code after tests pass\n- `/tdd` — Test-driven development workflow\n\n## Related\n\n- Agent: `agents/flutter-reviewer.md`\n- Agent: `agents/dart-build-resolver.md`\n- Skill: `skills/flutter-dart-code-review/`\n- Rules: `rules/dart/testing.md`", "variables": [], "notes": "Run Flutter/Dart tests, report failures, and incrementally fix test issues. Covers unit, widget, golden, and integration tests.", "metadata": { "source": { "provider": "github-claude-commands", "repository": "https://github.com/zero3041/PREP", "path": ".claude/commands/commands/flutter-test.md", "ref": "ab66111a27ac7b074c19b87aba0e1590272b14fb", "url": "https://github.com/zero3041/PREP/blob/ab66111a27ac7b074c19b87aba0e1590272b14fb/.claude/commands/commands/flutter-test.md", "key": "zero3041/PREP/.claude/commands/commands/flutter-test.md" } } }

flutter-test

About

Flutter Test

What This Command Does

When to Use

Commands Run

Example Session

Common Test Failures

Related Commands

Related

Install flutter-test and it becomes one more candidate the router can pick - when it fits.

Use it

Manifest

Reviews