qa-skills 3.0.0 → 3.1.0

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

@@ -1,309 +0,0 @@
-# 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

@@ -1,304 +0,0 @@
-# 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'),
-);
-```