qa-skills 3.0.0

package/skills/qa-mobile-test-writer/references/config.md

@@ -0,0 +1,309 @@
+# Mobile Test Configuration
+
+## Appium Setup
+
+### Installation
+
+```bash
+npm install -g appium
+appium driver install xcuitest   # iOS
+appium driver install uiautomator2  # Android
+```
+
+### Appium Server
+
+```bash
+# Start server (default port 4723)
+appium
+
+# Custom port
+appium --port 4724
+
+# With logs
+appium --log ./logs/appium.log
+```
+
+### WebdriverIO + Appium Service
+
+```typescript
+// wdio.conf.ts
+import type { Options } from '@wdio/types';
+
+export const config: Options.Testrunner = {
+  port: 4723,
+  path: '/',
+  specs: ['./test/specs/**/*.ts'],
+  capabilities: [
+    {
+      platformName: 'Android',
+      'appium:automationName': 'UiAutomator2',
+      'appium:deviceName': 'emulator-5554',
+      'appium:app': './apps/myapp.apk',
+      'appium:noReset': true,
+    },
+  ],
+  services: [
+    ['appium', {
+      args: { address: 'localhost', port: 4723 },
+      logPath: './logs/',
+    }],
+  ],
+  framework: 'mocha',
+  // ...
+};
+```
+
+---
+
+## Desired Capabilities
+
+### Android (UiAutomator2)
+
+```javascript
+{
+  platformName: 'Android',
+  'appium:automationName': 'UiAutomator2',
+  'appium:deviceName': 'emulator-5554',
+  'appium:udid': 'emulator-5554',  // or device serial
+  'appium:app': '/path/to/app.apk',
+  'appium:appPackage': 'com.example.app',
+  'appium:appActivity': '.MainActivity',
+  'appium:noReset': true,
+  'appium:fullReset': false,
+  'appium:newCommandTimeout': 60,
+}
+```
+
+### iOS (XCUITest)
+
+```javascript
+{
+  platformName: 'iOS',
+  'appium:automationName': 'XCUITest',
+  'appium:deviceName': 'iPhone 15',
+  'appium:udid': '...',  // Simulator or device UDID
+  'appium:app': '/path/to/app.app',
+  'appium:bundleId': 'com.example.app',
+  'appium:noReset': true,
+  'appium:fullReset': false,
+  'appium:newCommandTimeout': 60,
+}
+```
+
+### Mobile Web (Chrome on Android)
+
+```javascript
+{
+  platformName: 'Android',
+  'appium:automationName': 'UiAutomator2',
+  'appium:deviceName': 'emulator-5554',
+  browserName: 'Chrome',
+  'appium:chromedriverAutodownload': true,
+}
+```
+
+### Mobile Web (Safari on iOS)
+
+```javascript
+{
+  platformName: 'iOS',
+  'appium:automationName': 'XCUITest',
+  'appium:deviceName': 'iPhone 15',
+  browserName: 'Safari',
+}
+```
+
+---
+
+## Emulators and Simulators
+
+### Android Emulator
+
+```bash
+# List AVDs
+emulator -list-avds
+
+# Start emulator
+emulator -avd Pixel_6_API_34 -no-snapshot-load
+
+# Verify device
+adb devices
+```
+
+### iOS Simulator
+
+```bash
+# List simulators
+xcrun simctl list devices
+
+# Boot simulator
+xcrun simctl boot "iPhone 15"
+
+# Install app
+xcrun simctl install booted /path/to/app.app
+```
+
+### Capability for Emulator
+
+```javascript
+// Android
+'appium:deviceName': 'emulator-5554',
+'appium:udid': 'emulator-5554',
+
+// iOS (use UDID from simctl list)
+'appium:deviceName': 'iPhone 15',
+'appium:udid': '12345678-1234-1234-1234-123456789012',
+```
+
+---
+
+## Device Farms
+
+### BrowserStack
+
+```javascript
+{
+  'bstack:options': {
+    userName: process.env.BROWSERSTACK_USER,
+    accessKey: process.env.BROWSERSTACK_KEY,
+    projectName: 'My Project',
+    buildName: 'Build 1',
+    sessionName: 'Login test',
+  },
+  platformName: 'Android',
+  'appium:deviceName': 'Samsung Galaxy S23',
+  'appium:platformVersion': '13',
+  'appium:app': 'bs://<app-id>',
+  'appium:automationName': 'UiAutomator2',
+}
+```
+
+**Capability URL:** `https://app-automate.browserstack.com/wd/hub`
+
+### Sauce Labs
+
+```javascript
+{
+  'sauce:options': {
+    username: process.env.SAUCE_USERNAME,
+    accessKey: process.env.SAUCE_ACCESS_KEY,
+    build: 'Build 1',
+    name: 'Login test',
+  },
+  platformName: 'Android',
+  'appium:deviceName': 'Android GoogleAPI Emulator',
+  'appium:platformVersion': '13',
+  'appium:app': 'storage:filename=app.apk',
+  'appium:automationName': 'UiAutomator2',
+}
+```
+
+**Capability URL:** `https://ondemand.us-west-1.saucelabs.com/wd/hub`
+
+### AWS Device Farm
+
+```javascript
+{
+  platformName: 'Android',
+  'appium:deviceName': 'Pixel 6',
+  'appium:platformVersion': '13',
+  'appium:app': process.env.DEVICE_FARM_APP_ARN,
+  'appium:automationName': 'UiAutomator2',
+}
+```
+
+Use AWS Device Farm test runner; upload app and test package via AWS CLI or console.
+
+---
+
+## Flutter Configuration
+
+### integration_test Setup
+
+```yaml
+# pubspec.yaml
+dev_dependencies:
+  flutter_test:
+    sdk: flutter
+  integration_test:
+    sdk: flutter
+```
+
+### Directory Structure
+
+```
+my_app/
+  integration_test/
+    app_test.dart
+  lib/
+    main.dart
+```
+
+### Run Flutter Integration Tests
+
+```bash
+# On connected device/emulator
+flutter test integration_test/app_test.dart
+
+# With driver (legacy)
+flutter drive --target=test_driver/app.dart
+```
+
+### Flutter Driver (Legacy)
+
+```dart
+// test_driver/app.dart
+import 'package:flutter_driver/driver_extension.dart';
+import 'package:my_app/main.dart' as app;
+
+void main() {
+  enableFlutterDriverExtension();
+  app.main();
+}
+```
+
+---
+
+## CI Integration
+
+### GitHub Actions (Appium + Android Emulator)
+
+```yaml
+- uses: reactivecircus/android-emulator-runner@v2
+  with:
+    api-level: 34
+    script: npx wdio run wdio.conf.ts
+```
+
+### GitHub Actions (iOS Simulator)
+
+```yaml
+- uses: maxim-lobanov/setup-xcode@v1
+  with:
+    xcode-version: '15.0'
+- run: xcrun simctl boot "iPhone 15"
+- run: npx wdio run wdio.ios.conf.ts
+```
+
+### Environment Variables
+
+| Variable | Purpose |
+|----------|---------|
+| `BROWSERSTACK_USER` | BrowserStack username |
+| `BROWSERSTACK_KEY` | BrowserStack access key |
+| `SAUCE_USERNAME` | Sauce Labs username |
+| `SAUCE_ACCESS_KEY` | Sauce Labs access key |
+| `APP_PATH` | Path to .apk / .app |
+| `DEVICE_UDID` | Device or simulator UDID |
+
+---
+
+## Key Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `noReset` | Reuse app state; don't clear data | false |
+| `fullReset` | Uninstall and reinstall app | false |
+| `newCommandTimeout` | Idle timeout (seconds) | 60 |
+| `autoGrantPermissions` | Auto-accept runtime permissions | false |
+| `chromedriverAutodownload` | Auto-download ChromeDriver (Android) | false |

package/skills/qa-mobile-test-writer/references/patterns.md

@@ -0,0 +1,304 @@
+# Mobile Test Patterns
+
+## Native Apps
+
+### Element Location Strategies
+
+| Strategy | iOS | Android | Priority |
+|----------|-----|---------|----------|
+| **accessibility id** | accessibilityIdentifier | content-desc / resource-id | 1 (most stable) |
+| **resource-id** | — | resource-id | 1 (Android) |
+| **id** | — | id attribute | 1 (Android) |
+| **class name** | XCUIElementType* | android.widget.* | 2 |
+| **xpath** | Full path | Full path | 3 (last resort) |
+| **predicate** | -ios predicate string | — | 2 (iOS) |
+| **uiautomator** | — | -android uiautomator | 2 (Android) |
+
+### Appium Native Example
+
+```javascript
+// Appium (WebdriverIO)
+const loginBtn = await $('~login-button');  // accessibility id
+await loginBtn.click();
+
+// Android resource-id
+const submitBtn = await $('id=com.example:id/submit');
+await submitBtn.click();
+
+// iOS predicate
+const cell = await $('-ios predicate string:name == "Settings"');
+await cell.click();
+
+// Android UiAutomator
+const item = await $('-android uiautomator:new UiSelector().text("Submit")');
+await item.click();
+```
+
+### Flutter Native Example
+
+```dart
+// integration_test/app_test.dart
+import 'package:flutter_test/flutter_test.dart';
+import 'package:integration_test/integration_test.dart';
+import 'package:my_app/main.dart' as app;
+
+void main() {
+  IntegrationTestWidgetsFlutterBinding.ensureInitialized();
+
+  testWidgets('login flow', (tester) async {
+    app.main();
+    await tester.pumpAndSettle();
+
+    await tester.tap(find.byKey(Key('login-button')));
+    await tester.pumpAndSettle();
+
+    await tester.enterText(find.byKey(Key('email-field')), 'user@test.com');
+    await tester.enterText(find.byKey(Key('password-field')), 'secret');
+    await tester.tap(find.byKey(Key('submit-button')));
+    await tester.pumpAndSettle();
+
+    expect(find.text('Welcome'), findsOneWidget);
+  });
+}
+```
+
+---
+
+## Hybrid Apps
+
+### Context Switching
+
+Hybrid apps have native and webview contexts. Switch to webview to interact with web content.
+
+```javascript
+// Get all contexts
+const contexts = await driver.getContexts();
+// ['NATIVE_APP', 'WEBVIEW_com.example.app']
+
+// Switch to webview
+await driver.switchContext('WEBVIEW_com.example.app');
+
+// Use web selectors (CSS, XPath)
+await $('input[name="email"]').setValue('user@test.com');
+await $('button[type="submit"]').click();
+
+// Switch back to native
+await driver.switchContext('NATIVE_APP');
+```
+
+### Webview Detection
+
+```javascript
+// Wait for webview to appear
+await driver.waitUntil(
+  async () => (await driver.getContexts()).some(c => c.includes('WEBVIEW')),
+  { timeout: 10000 }
+);
+```
+
+---
+
+## Gestures
+
+### Touch Actions (Legacy)
+
+```javascript
+// Single tap
+await element.touchAction('tap');
+
+// Long press
+await element.touchAction([
+  { action: 'longPress' },
+  { action: 'release' }
+]);
+
+// Swipe
+await driver.touchAction([
+  { action: 'press', x: 300, y: 800 },
+  { action: 'wait', ms: 500 },
+  { action: 'moveTo', x: 300, y: 200 },
+  { action: 'release' }
+]);
+
+// Scroll (element-based)
+await element.touchAction([
+  { action: 'press', x: 150, y: 500 },
+  { action: 'moveTo', x: 150, y: 100 },
+  { action: 'release' }
+]);
+```
+
+### W3C Actions API (Preferred)
+
+```javascript
+// Tap
+await driver.performActions([
+  {
+    type: 'pointer',
+    id: 'finger1',
+    parameters: { pointerType: 'touch' },
+    actions: [
+      { type: 'pointerMove', duration: 0, x: 100, y: 200 },
+      { type: 'pointerDown', button: 0 },
+      { type: 'pointerUp', button: 0 }
+    ]
+  }
+]);
+
+// Swipe
+await driver.performActions([
+  {
+    type: 'pointer',
+    id: 'finger1',
+    parameters: { pointerType: 'touch' },
+    actions: [
+      { type: 'pointerMove', duration: 0, x: 200, y: 600 },
+      { type: 'pointerDown', button: 0 },
+      { type: 'pause', duration: 100 },
+      { type: 'pointerMove', duration: 300, x: 200, y: 200 },
+      { type: 'pointerUp', button: 0 }
+    ]
+  }
+]);
+```
+
+### Scroll to Element
+
+```javascript
+// Scroll until element visible (Appium)
+await driver.execute('mobile: scroll', {
+  direction: 'down',
+  predicateString: 'name == "Target Element"'
+});
+
+// Or use scrollIntoView (if supported)
+await element.scrollIntoView();
+```
+
+---
+
+## App Lifecycle
+
+### Install / Uninstall
+
+```javascript
+// Install app
+await driver.installApp('/path/to/app.apk');
+await driver.installApp('https://example.com/app.apk');
+
+// Uninstall
+await driver.removeApp('com.example.app');
+```
+
+### Launch / Terminate
+
+```javascript
+// Launch (activate) app
+await driver.activateApp('com.example.app');
+
+// Terminate
+await driver.terminateApp('com.example.app');
+```
+
+### Reset Options
+
+| Capability | Effect |
+|------------|--------|
+| `noReset: true` | Reuse app state; faster; may leave data |
+| `fullReset: true` | Uninstall + reinstall; clean state |
+| `dontStopAppOnReset: true` | Don't stop app before session |
+
+### Background / Foreground
+
+```javascript
+// Send app to background
+await driver.background(5);  // 5 seconds
+
+// Resume
+await driver.activateApp('com.example.app');
+```
+
+---
+
+## Deep Links
+
+### Open Deep Link
+
+```javascript
+// Android
+await driver.execute('mobile: deepLink', {
+  url: 'myapp://screen/detail/123',
+  package: 'com.example.app'
+});
+
+// iOS
+await driver.execute('mobile: launchApp', {
+  bundleId: 'com.example.app',
+  arguments: ['--url', 'myapp://screen/detail/123']
+});
+```
+
+### URL Scheme (Alternative)
+
+```javascript
+// Open URL that triggers app
+await driver.url('myapp://screen/detail/123');
+```
+
+---
+
+## Mobile Web
+
+### Capabilities for Mobile Browser
+
+```javascript
+// Android Chrome
+{
+  platformName: 'Android',
+  'appium:automationName': 'UiAutomator2',
+  browserName: 'Chrome',
+  'appium:deviceName': 'emulator-5554'
+}
+
+// iOS Safari
+{
+  platformName: 'iOS',
+  'appium:automationName': 'XCUITest',
+  browserName: 'Safari',
+  'appium:deviceName': 'iPhone 15'
+}
+```
+
+### Mobile Web Selectors
+
+Use standard web selectors (CSS, XPath) when context is browser. Viewport and touch behavior differ from desktop.
+
+---
+
+## Flutter Finders
+
+| Finder | Use Case |
+|--------|----------|
+| `find.byKey(Key('id'))` | Stable; requires Key in widget |
+| `find.text('Label')` | Visible text |
+| `find.byType(MyWidget)` | Widget type |
+| `find.bySemanticsLabel('label')` | Accessibility |
+| `find.byIcon(Icons.add)` | Icon |
+| `find.byTooltip('tip')` | Tooltip |
+
+### Pumping
+
+```dart
+await tester.pump();           // One frame
+await tester.pump(Duration(seconds: 1));  // Advance time
+await tester.pumpAndSettle();  // Pump until no more frames (animations done)
+```
+
+### Golden Tests
+
+```dart
+await expectLater(
+  find.byType(MyWidget),
+  matchesGoldenFile('goldens/my_widget.png'),
+);
+```