swipium 1.1.0 → 1.3.0

package/README.md

@@ -236,27 +236,32 @@ After setup, verify that the client lists `qa_test_this`, `qa_capabilities`, and
 
 ## Tool Docs
 
-Swipium exposes 59 public MCP tools. Start with `qa_test_this` for low-context requests.
+Swipium exposes 91 public MCP tools. Start with `qa_test_this` for low-context requests.
 
 Full reference: [docs/tools.md](docs/tools.md)
 
-New in 1.1.0 — 17 additional tools, all backward compatible:
+New in 1.3.0 — 8 additional tools, all backward compatible:
 
-- **Device and app environment parity** (no raw `adb`/`simctl`): `qa_device_info`, `qa_permissions`, `qa_orientation`, `qa_geolocation`, `qa_network`, `qa_metro`, `qa_app_control`, `qa_screen_info`, `qa_screen_record`. Mutating actions are consent-gated and recorded; network changes auto-restore at report end.
-- **Local-first visual intelligence**: `qa_visual` (baseline, regression diff, image-target matching with tappable coordinates, optional OCR) and `qa_visual_find_text` (OCR text location with coordinate-space conversion).
-- **Seeded state**: `qa_seed`, `qa_state_prepare`, `qa_state_verify`, `qa_state_teardown` — create and verify a reproducible precondition instead of only reporting it as missing.
-- **Report history**: `qa_report_compare` (diff a run against a baseline) and `qa_run_history` (pass rate, failures, flaky flows, confidence calibration across local runs).
+- **Feature-focused testing**: `qa_feature_scope`, `qa_feature_test_plan`, `qa_test_feature` — test a specific feature by name ("the login flow"), backed by the app knowledge map.
+- **Local build and artifact resolution**: `qa_resolve_target`, `qa_resolve_artifact`, `qa_build_plan`, `qa_build`, `qa_bundletool` — pick a device, find or build an installable artifact, and convert an `.aab` to an installable APK.
+
+Earlier releases added device-parity, local-first visual, seeded-state, report-history (1.1.0) and durable issue memory, persistent test suite, flow plan/repair, Maestro interop, and agent helpers (1.2.0).
 
 | Group | Tools |
 | --- | --- |
-| Start | `qa_agent_brief`, `qa_capabilities`, `qa_test_this`, `qa_job_status`, `qa_status`, `qa_explain_blocker`, `qa_continue_from_blocker`, `qa_get_artifact` |
+| Start | `qa_agent_brief`, `qa_capabilities`, `qa_test_this`, `qa_job_status`, `qa_job_cancel`, `qa_status`, `qa_explain_blocker`, `qa_continue_from_blocker`, `qa_get_artifact` |
 | Setup | `qa_doctor`, `qa_start_session`, `qa_detect_context`, `qa_plan`, `qa_prepare_target`, `qa_prepare_ios_target`, `qa_ios`, `qa_wda` |
+| Build | `qa_resolve_target`, `qa_resolve_artifact`, `qa_build_plan`, `qa_build`, `qa_bundletool` |
 | Device | `qa_device_info`, `qa_permissions`, `qa_orientation`, `qa_geolocation`, `qa_network`, `qa_metro`, `qa_app_control`, `qa_screen_info`, `qa_screen_record` |
-| Drive | `qa_snapshot`, `qa_act`, `qa_clear_overlay`, `qa_check_health`, `qa_screenshot`, `qa_note`, `qa_assert_visual`, `qa_visual`, `qa_visual_find_text` |
+| Drive | `qa_snapshot`, `qa_act`, `qa_clear_overlay`, `qa_check_health`, `qa_screenshot`, `qa_note`, `qa_assert_visual`, `qa_visual`, `qa_visual_find_text`, `qa_locator_suggest`, `qa_input_capabilities`, `qa_wait`, `qa_idling_status` |
 | State | `qa_seed`, `qa_state_prepare`, `qa_state_verify`, `qa_state_teardown` |
 | Run | `qa_smoke`, `qa_explore`, `qa_report`, `qa_report_compare`, `qa_run_history` |
 | App map | `qa_app_map_build`, `qa_app_map_read`, `qa_app_map_query`, `qa_app_map_feature_scope`, `qa_app_map_validate` |
-| Flows and suites | `qa_flow_check`, `qa_flow_run`, `qa_flow_generate`, `qa_suite_generate`, `qa_suite_compile`, `qa_testcase_generate` |
+| Feature | `qa_feature_scope`, `qa_feature_test_plan`, `qa_test_feature` |
+| Flows and suites | `qa_flow_check`, `qa_flow_plan`, `qa_flow_run`, `qa_flow_generate`, `qa_flow_repair`, `qa_suite_generate`, `qa_suite_compile`, `qa_suite_lint`, `qa_pom_generate`, `qa_testcase_generate` |
+| Test suite | `qa_test_suite_read`, `qa_test_suite_update`, `qa_test_suite_generate`, `qa_test_suite_export`, `qa_test_suite_lint` |
+| Interop | `qa_maestro_import`, `qa_maestro_export` |
+| Issues | `qa_issue_log`, `qa_issue_history`, `qa_issue_mark_fixed`, `qa_issue_triage`, `qa_issue_suppress`, `qa_issue_verify_fixed`, `qa_issue_metrics`, `qa_mobile_audit` |
 | First run | `qa_first_run_plan`, `qa_first_run_continue` |
 | Automation | `qa_automation_plan`, `qa_automation_generate`, `qa_automation_validate` |
 

package/THREAT_MODEL.md

@@ -0,0 +1,59 @@
+# Swipium Threat Model
+
+Last updated: 2026-06-02 (Swipium 2.1.0)
+
+This document describes Swipium's trust boundaries, the threats it defends against, and the controls that enforce those defenses. It follows the MCP security guidance: validate inputs, use least privilege, obtain explicit consent for sensitive operations, protect secrets, and do not over-trust tool metadata.
+
+## What Swipium Is
+
+Swipium is a local stdio MCP server that lets an AI agent run mobile QA against an Android Emulator or iOS Simulator on the developer's own machine. It is not a remote service. It has no network listener, no authentication surface, and no multi-tenant state.
+
+## Trust Boundaries
+
+1. MCP client to Swipium: the client (Claude, Gemini, Codex, or another MCP host) sends tool calls over stdio. Swipium trusts the transport but not the semantic intent: destructive actions require explicit, server-side consent regardless of what the client requests.
+2. Swipium to local toolchain: Swipium shells out to `adb`, `emulator`, `xcrun`/`simctl`, Gradle, and Metro. These run with the developer's own privileges. Swipium does not escalate privileges.
+3. Swipium to the project: Swipium reads and writes within the resolved project root and `.swipium/`. It does not write outside the project root without explicit approval.
+4. App under test to Swipium: screenshots, UI dumps, and logs from the app can contain sensitive data. Swipium treats this data as untrusted and redacts known secret shapes before surfacing it.
+
+## Assets
+
+- Developer machine integrity and the local toolchain.
+- The project source tree and `.swipium/` state (config, app map, flows, issue ledger, run history).
+- Secrets the agent handles during testing (credentials, OTPs, tokens).
+- App data on the emulator/simulator.
+
+## Adversaries and Threats
+
+- Malicious or compromised MCP client / prompt injection: a client (or a poisoned tool description in another server) tries to trigger a destructive or exfiltrating action. Mitigation: server-side consent state machine for all destructive/privileged actions; exact command and effect are shown before execution; consent is per-action and not satisfiable by client assertion alone. Tool descriptions are linted (`test/toolMetadata.test.ts`) to stay honest and non-manipulative.
+- Untrusted app content: the app renders attacker-controlled text (deep links, usernames, server responses) that could carry injection payloads into the transcript. Mitigation: snapshots and logs are structured and redacted; Swipium does not execute app-derived text as commands.
+- Accidental data loss: a data wipe (`clear_data`, `fresh_start`) on a debug RN/Expo build removes the cached JS bundle and breaks the app. Mitigation: these actions are consent-gated high and additionally require `acknowledgeBundleRisk:true`; `qa_plan` surfaces `fresh_start` as UNSAFE with reason `bundle_cache_loss`.
+- Environment left dirty: a run changes network state or leaves a recorder or Metro bundler running. Mitigation: network changes record the original state and auto-restore at report end, on `restore`, and on server shutdown; screen recordings and Metro bundlers are stopped on shutdown.
+- Secret leakage into artifacts/reports: credentials or tokens entered during testing get written to logs, dumps, or reports. Mitigation: secret values provided via `qa_continue_from_blocker` are registered for redaction; known secret shapes are redacted from snapshots and reports; sensitive mode withholds screenshots and visual OCR on password/OTP screens.
+- Sensitive-screen capture: screen recording or OCR captures a password/payment screen. Mitigation: recording and visual OCR are consent-gated, refuse sensitive sessions, and visual text/diff ops are withheld when a secure field is on screen unless explicitly forced.
+- Untrusted seed/fixture execution: a fixture seed runs a local script or API call. Mitigation: all seed/state mutations are consent-gated with risk scaled by type (`script` high), git commands are refused, and seed failures are reported as setup failures, not app bugs.
+- Stale client after upgrade: an MCP client keeps an old server process after an upgrade, exposing a stale tool surface. Mitigation: version and tool-count are reported on start and by `qa_doctor`; a stale-client hint is shown.
+
+## Controls Summary
+
+- Server-side consent state machine with exact command/effect display and project-root boundary.
+- Destructive-action guardrails (bundle-loss refusal) that the client cannot override.
+- Secret redaction and sensitive-screen mode.
+- Network restore and recorder/Metro shutdown hooks.
+- External artifact handling within the project root; no writes outside without approval.
+- Tool metadata lint and public tool-surface lockstep tests.
+- Coordinate-space metadata on all visual results.
+
+## Explicit Non-Goals (Current Scope)
+
+Swipium is simulator-local. The following are intentionally out of scope until a dedicated design and threat model exist for each:
+
+- Remote or HTTP transport, authentication, and multi-tenant operation.
+- Real-device execution.
+- External service integrations (for example issue trackers or CI back-ends that send data off the machine).
+- Remote AI vision that sends screenshots to a third-party service by default.
+
+Adding any of these requires extending this document first.
+
+## Reporting
+
+Security issues should be reported per `SECURITY.md`.

package/dist/appMap/diff.js

@@ -0,0 +1,60 @@
+// Map diff (SWIPIUM-REQ-01 qa_app_map_diff). Reports added/removed/changed screens, feature
+// coverage changes, stale test cases, locator-readiness changes, and new untested code areas
+// between two AppKnowledgeMap snapshots. Pure — the tool layer resolves which two maps to compare.
+function ids(arr) {
+    return new Set(arr.map((a) => a.id));
+}
+export function diffAppMaps(baseline, current) {
+    const baseStatic = ids(baseline.staticTopology.screens);
+    const curStatic = ids(current.staticTopology.screens);
+    const baseRuntime = ids(baseline.runtimeTopology.screens);
+    const curRuntime = ids(current.runtimeTopology.screens);
+    const staticAdded = [...curStatic].filter((id) => !baseStatic.has(id));
+    const staticRemoved = [...baseStatic].filter((id) => !curStatic.has(id));
+    const runtimeAdded = [...curRuntime].filter((id) => !baseRuntime.has(id));
+    const runtimeRemoved = [...baseRuntime].filter((id) => !curRuntime.has(id));
+    // changed runtime screens: visits / link / readiness drift
+    const changedScreens = [];
+    const locatorReadinessChanges = [];
+    for (const cur of current.runtimeTopology.screens) {
+        const prev = baseline.runtimeTopology.screens.find((s) => s.id === cur.id || s.signature === cur.signature);
+        if (!prev)
+            continue;
+        if (prev.linkedStaticScreenId !== cur.linkedStaticScreenId) {
+            changedScreens.push({ id: cur.id, field: 'linkedStaticScreenId', was: prev.linkedStaticScreenId ?? null, now: cur.linkedStaticScreenId ?? null });
+        }
+        if (prev.locatorReadiness !== cur.locatorReadiness) {
+            locatorReadinessChanges.push({ id: cur.id, was: prev.locatorReadiness, now: cur.locatorReadiness });
+        }
+    }
+    // feature coverage changes
+    const featureCoverageChanges = [];
+    for (const cur of current.features) {
+        const prev = baseline.features.find((f) => f.id === cur.id);
+        if (prev && prev.testCoverage !== cur.testCoverage) {
+            featureCoverageChanges.push({ featureId: cur.id, was: prev.testCoverage, now: cur.testCoverage });
+        }
+    }
+    // stale tests: cases whose feature/screen no longer exists in current
+    const curFeatureIds = ids(current.features);
+    const staleTests = current.testSuite.cases
+        .filter((c) => (c.featureId && !curFeatureIds.has(c.featureId)) || (c.screenId && !curStatic.has(c.screenId) && !curRuntime.has(c.screenId)) || c.stale)
+        .map((c) => c.id);
+    // new untested code areas: newly added static screens with no linked runtime screen
+    const linkedStatic = new Set(current.runtimeTopology.screens.map((r) => r.linkedStaticScreenId).filter(Boolean));
+    const newUntestedCodeAreas = staticAdded.filter((id) => !linkedStatic.has(id));
+    const summary = `+${staticAdded.length}/-${staticRemoved.length} static screens, +${runtimeAdded.length}/-${runtimeRemoved.length} runtime screens; ` +
+        `${featureCoverageChanges.length} coverage change(s), ${locatorReadinessChanges.length} locator-readiness change(s), ` +
+        `${staleTests.length} stale test(s), ${newUntestedCodeAreas.length} new untested area(s)`;
+    return {
+        staticScreens: { added: staticAdded, removed: staticRemoved },
+        runtimeScreens: { added: runtimeAdded, removed: runtimeRemoved },
+        changedScreens,
+        featureCoverageChanges,
+        locatorReadinessChanges,
+        staleTests,
+        newUntestedCodeAreas,
+        summary,
+    };
+}
+//# sourceMappingURL=diff.js.map

package/dist/appMap/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/appMap/diff.ts"],"names":[],"mappings":"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"}

package/dist/appMap/featureIndex.js

@@ -0,0 +1,183 @@
+// Code-aware feature index (SWIPIUM-REQ-03, foundation from SWIPIUM-REQ-01). A deterministic,
+// LLM-free static index over the project's source so a natural-language feature request can be
+// mapped to concrete code: screen/component/service/hook symbols, navigation route names, and
+// per-file token sets. Pure logic lives in tokenize/extractSymbols/extractRoutes (unit-tested
+// without a filesystem); buildFeatureIndex walks the tree and applies them.
+//
+// v1 is intentionally deterministic (Non-Goals): regex + name heuristics, not semantic analysis.
+// The schema carries tokens so synonym/locale expansion can happen at query time later.
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { join, relative, extname, basename } from 'node:path';
+const SOURCE_EXT = new Set(['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs', '.swift', '.kt', '.java', '.dart', '.vue']);
+const SKIP_DIRS = new Set([
+    'node_modules', '.git', '.svn', '.hg', 'dist', 'build', 'out', 'coverage', '.next', '.expo',
+    '.gradle', 'Pods', 'DerivedData', 'vendor', '.swipium', '__snapshots__', '.cache', 'tmp', '.idea', '.vscode',
+]);
+/** Split an identifier (camelCase / PascalCase / snake_case / kebab-case) into lowercase word tokens. */
+export function tokenize(name) {
+    return name
+        .replace(/([a-z0-9])([A-Z])/g, '$1 $2') // camelCase boundary
+        .replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2') // ACRONYMWord boundary
+        .split(/[^A-Za-z0-9]+/)
+        .map((t) => t.trim().toLowerCase())
+        .filter((t) => t.length > 1 && !/^\d+$/.test(t));
+}
+/** Classify a symbol by conventional name suffixes/prefixes — deterministic, English-leaning v1. */
+export function classifySymbol(name) {
+    if (/^use[A-Z]/.test(name))
+        return 'hook';
+    if (/(Screen|Page|View|Activity|Fragment|Route)$/.test(name))
+        return 'screen';
+    if (/(Service|Api|Client|Repository|Store|Manager|Provider|Controller|Analyzer|Engine)$/.test(name))
+        return 'service';
+    if (/(Component|Card|Button|List|Modal|Sheet|Header|Footer|Item|Row|Tile|Widget)$/.test(name))
+        return 'component';
+    if (/^[A-Z]/.test(name))
+        return 'component'; // PascalCase default → likely a component/class
+    return 'function';
+}
+/** Extract declared symbol names from a source file's text (JS/TS/Swift/Kotlin/Java/Dart). PURE. */
+export function extractSymbols(text) {
+    const out = [];
+    const seen = new Set();
+    const lines = text.split('\n');
+    const patterns = [
+        // JS/TS declarations
+        /(?:export\s+)?(?:default\s+)?(?:async\s+)?function\s+([A-Za-z_$][\w$]*)/,
+        /(?:export\s+)?(?:abstract\s+)?class\s+([A-Za-z_$][\w$]*)/,
+        /(?:export\s+)?const\s+([A-Za-z_$][\w$]*)\s*(?::[^=]+)?=\s*(?:async\s*)?(?:\(|function|React\.|memo\(|forwardRef\(|styled)/,
+        /(?:export\s+)?(?:interface|type|enum)\s+([A-Za-z_$][\w$]*)/,
+        // Swift / Kotlin / Java
+        /(?:struct|protocol|extension)\s+([A-Z][\w]*)/,
+        /(?:fun|func)\s+([A-Za-z_][\w]*)/,
+        // Dart / Kotlin widgets
+        /(?:Widget|StatelessWidget|StatefulWidget)\s+([A-Z][\w]*)/,
+    ];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        for (const re of patterns) {
+            const m = re.exec(line);
+            if (!m)
+                continue;
+            const name = m[1];
+            const key = `${name}@${i}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            out.push({ name, kind: classifySymbol(name), line: i + 1 });
+        }
+    }
+    return out;
+}
+/** Extract navigation route / deep-link names from a source file's text. PURE. */
+export function extractRoutes(text) {
+    const out = [];
+    const seen = new Set();
+    const lines = text.split('\n');
+    const patterns = [
+        /\bpath\s*:\s*['"`]([^'"`]+)['"`]/g, // react-router / vue-router { path: '/weather' }
+        /\b(?:name|routeName|screen)\s*:\s*['"`]([A-Za-z][^'"`]*)['"`]/g, // { name: 'WeatherAnalysis' }
+        /<(?:Stack|Tab|Drawer|NativeStack)?\.?Screen\b[^>]*\bname\s*=\s*['"`]([^'"`]+)['"`]/g, // RN <Stack.Screen name="Weather" />
+        /navigation\.(?:navigate|push|replace)\(\s*['"`]([^'"`]+)['"`]/g, // navigation.navigate('Weather')
+        /(?:Link|NavLink|router\.push)\(?\s*[^'"`]*['"`](\/[A-Za-z][^'"`]*)['"`]/g, // router.push('/weather')
+        /['"`]([a-z][\w.+-]*:\/\/[^'"`\s]+)['"`]/g, // deep links myapp://weather
+    ];
+    for (let i = 0; i < lines.length; i++) {
+        for (const re of patterns) {
+            re.lastIndex = 0;
+            let m;
+            while ((m = re.exec(lines[i]))) {
+                const route = m[1];
+                if (!route || route.length > 80)
+                    continue;
+                const key = `${route}@${i}`;
+                if (seen.has(key))
+                    continue;
+                seen.add(key);
+                out.push({ route, line: i + 1 });
+            }
+        }
+    }
+    return out;
+}
+/** Tokenize a route string into searchable terms (drops scheme/slashes/params). */
+function routeTokens(route) {
+    return tokenize(route.replace(/^[a-z]+:\/\//i, '').replace(/[/:?#&=]/g, ' '));
+}
+/**
+ * Walk the project tree and build the static feature index. Reads files (best-effort) and applies
+ * the pure extractors. Skips build/vendor dirs and caps the file count to keep context bounded.
+ */
+export function buildFeatureIndex(root, opts = {}) {
+    const maxFiles = opts.maxFiles ?? 4000;
+    const maxBytes = opts.maxBytesPerFile ?? 512 * 1024;
+    const symbols = [];
+    const routes = [];
+    const files = [];
+    let scannedFiles = 0;
+    let truncated = false;
+    const walk = (dir) => {
+        if (scannedFiles >= maxFiles) {
+            truncated = true;
+            return;
+        }
+        let entries;
+        try {
+            entries = readdirSync(dir).sort();
+        }
+        catch {
+            return;
+        }
+        for (const name of entries) {
+            if (scannedFiles >= maxFiles) {
+                truncated = true;
+                return;
+            }
+            if (name.startsWith('.') && name !== '.')
+                continue;
+            const full = join(dir, name);
+            let st;
+            try {
+                st = statSync(full);
+            }
+            catch {
+                continue;
+            }
+            if (st.isDirectory()) {
+                if (SKIP_DIRS.has(name))
+                    continue;
+                walk(full);
+            }
+            else if (st.isFile()) {
+                const ext = extname(name).toLowerCase();
+                if (!SOURCE_EXT.has(ext))
+                    continue;
+                if (/\.(d\.ts|test\.[tj]sx?|spec\.[tj]sx?)$/.test(name))
+                    continue; // skip declarations + tests
+                if (st.size > maxBytes)
+                    continue;
+                const rel = relative(root, full);
+                const base = basename(name, ext);
+                files.push({ file: rel, base, tokens: tokenize(base) });
+                scannedFiles++;
+                let text;
+                try {
+                    text = readFileSync(full, 'utf8');
+                }
+                catch {
+                    continue;
+                }
+                for (const s of extractSymbols(text)) {
+                    symbols.push({ name: s.name, kind: s.kind, file: rel, line: s.line, tokens: tokenize(s.name) });
+                }
+                for (const r of extractRoutes(text)) {
+                    routes.push({ route: r.route, file: rel, line: r.line, tokens: routeTokens(r.route) });
+                }
+            }
+        }
+    };
+    if (existsSync(root))
+        walk(root);
+    return { root, symbols, routes, files, scannedFiles, truncated };
+}
+//# sourceMappingURL=featureIndex.js.map

package/dist/appMap/featureIndex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"featureIndex.js","sourceRoot":"","sources":["../../src/appMap/featureIndex.ts"],"names":[],"mappings":"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"}

package/dist/automation/capabilities.js

@@ -0,0 +1,167 @@
+// Automation Kernel V2 — Workstream 1: backend capability matrix. Pure functions that answer
+// "what can this backend actually do?" before any device is touched. The planner (plan.ts) consumes
+// these to classify each step as native / supported_with_fallback / visual_only / unsupported and to
+// name the exact missing capability when something cannot run.
+//
+// Driver.kind values map to backends as: 'direct' → android-direct, 'simulator' → ios-raw-simulator,
+// 'wda' → ios-wda, 'remote' → an Appium backend (uiautomator2 | xcuitest, disambiguated by session).
+function base(backend) {
+    return {
+        backend,
+        install: false,
+        launch: false,
+        terminate: false,
+        openUrl: false,
+        screenshot: false,
+        logs: false,
+        structuredTree: false,
+        nativeSelectors: false,
+        resourceId: false,
+        accessibilityId: false,
+        iosPredicate: false,
+        iosClassChain: false,
+        textSelector: false,
+        textInputAscii: false,
+        textInputUnicode: false,
+        clearText: false,
+        longPress: false,
+        doubleTap: false,
+        scrollUntilVisible: false,
+        pinch: false,
+        drag: false,
+        systemAlerts: false,
+        appDeclaredIdling: false,
+        wdaIdling: false,
+        webviewContexts: false,
+        screenRecording: false,
+        visualFallback: false,
+        ocrFallback: false,
+        notes: [],
+    };
+}
+/** Map a Swipium Driver.kind (+ optional Appium session) to an automation backend identity. */
+export function backendForDriverKind(kind, session) {
+    switch (kind) {
+        case 'direct':
+            return 'android-direct';
+        case 'simulator':
+            return 'ios-raw-simulator';
+        case 'wda':
+            return 'ios-wda';
+        case 'remote':
+            return appiumBackendFromSession(session);
+        default:
+            return 'unknown';
+    }
+}
+export function appiumBackendFromSession(session) {
+    const name = (session?.automationName ?? '').toLowerCase();
+    const platform = (session?.platformName ?? '').toLowerCase();
+    // iOS evidence first (an XCUITest automationName or an iOS platform), then Android.
+    if (name.includes('xcuitest') || platform.includes('ios'))
+        return 'appium-xcuitest';
+    // Android: infer UiAutomator2 from the driver name OR from Android platform evidence alone
+    // (espresso also implies an Android session).
+    if (name.includes('uiautomator2') || name.includes('espresso') || name.includes('android') || platform.includes('android'))
+        return 'appium-uiautomator2';
+    // Without driver/session evidence we cannot claim a concrete Appium driver family.
+    return 'unknown';
+}
+export function backendCapabilities(backend, session) {
+    const c = base(backend);
+    switch (backend) {
+        case 'android-direct':
+            // Android DirectDriver via adb + UI Automator dump: resource-id / text / accessibility tree,
+            // ascii text input, basic gestures. No WebView context switching, no app-declared idle proof.
+            Object.assign(c, {
+                install: true, launch: true, terminate: true, openUrl: true, screenshot: true, logs: true,
+                structuredTree: true, nativeSelectors: true, resourceId: true, accessibilityId: true,
+                textSelector: true, textInputAscii: true, textInputUnicode: false, clearText: true,
+                longPress: true, doubleTap: true, scrollUntilVisible: true, pinch: false, drag: true,
+                systemAlerts: true, appDeclaredIdling: false, screenRecording: true,
+                visualFallback: true, ocrFallback: true,
+            });
+            c.notes.push('Unicode text input is not safe on adb input; use a fixture-provided ASCII value or a stronger backend.');
+            c.notes.push('No WebView context switching on the Android direct backend; attach Appium UiAutomator2 for hybrid contexts.');
+            return c;
+        case 'ios-raw-simulator':
+            // simctl lifecycle + screenshot + deep links + visual/OCR only. NO structured taps/selectors.
+            Object.assign(c, {
+                install: true, launch: true, terminate: true, openUrl: true, screenshot: true, logs: true,
+                structuredTree: false, nativeSelectors: false, screenRecording: true,
+                visualFallback: true, ocrFallback: true,
+            });
+            c.notes.push('iOS raw simulator cannot run structured taps; attach WDA or Appium XCUITest for selector-based automation.');
+            return c;
+        case 'ios-wda':
+            // WebDriverAgent / XCTest: accessibility id / name / predicate / class-chain, idle settings.
+            Object.assign(c, {
+                install: true, launch: true, terminate: true, openUrl: true, screenshot: true, logs: true,
+                structuredTree: true, nativeSelectors: true, accessibilityId: true, iosPredicate: true,
+                iosClassChain: true, textSelector: true, textInputAscii: true, textInputUnicode: true,
+                clearText: true, longPress: true, doubleTap: true, scrollUntilVisible: true, pinch: false,
+                drag: true, systemAlerts: true, wdaIdling: true, screenRecording: true,
+                visualFallback: true, ocrFallback: true,
+            });
+            c.notes.push('iOS resource-id selectors do not exist; use accessibility id / name / predicate / class chain.');
+            c.notes.push('Pinch/zoom is capability-gated until a tested WDA/Appium implementation exists.');
+            return c;
+        case 'appium-uiautomator2':
+            Object.assign(c, {
+                install: true, launch: true, terminate: true, openUrl: true, screenshot: true, logs: true,
+                structuredTree: true, nativeSelectors: true, resourceId: true, accessibilityId: true,
+                textSelector: true, textInputAscii: true, textInputUnicode: true, clearText: true,
+                longPress: true, doubleTap: true, scrollUntilVisible: true, pinch: true, drag: true,
+                systemAlerts: true, appDeclaredIdling: false, screenRecording: true,
+                visualFallback: true, ocrFallback: true,
+                // Web/hybrid potential is only claimed when the live session reports contexts.
+                webviewContexts: session?.webviewContextsAvailable === true,
+            });
+            if (!c.webviewContexts)
+                c.notes.push('WebView contexts only available when the Appium session reports a non-native context; not claimed without session evidence.');
+            return c;
+        case 'appium-xcuitest':
+            Object.assign(c, {
+                install: true, launch: true, terminate: true, openUrl: true, screenshot: true, logs: true,
+                structuredTree: true, nativeSelectors: true, accessibilityId: true, iosPredicate: true,
+                iosClassChain: true, textSelector: true, textInputAscii: true, textInputUnicode: true,
+                clearText: true, longPress: true, doubleTap: true, scrollUntilVisible: true, pinch: true,
+                drag: true, systemAlerts: true, wdaIdling: true, screenRecording: true,
+                visualFallback: true, ocrFallback: true,
+                webviewContexts: session?.webviewContextsAvailable === true,
+            });
+            c.notes.push('XCUITest sessions expose WDA settings (snapshot depth, waitForIdleTimeout, reduceMotion); bind automation evidence to them.');
+            if (!c.webviewContexts)
+                c.notes.push('WebView contexts only available when the Appium session reports a non-native context; not claimed without session evidence.');
+            return c;
+        case 'unknown':
+        default:
+            c.notes.push('Backend is unknown; attach a device/session so capabilities can be resolved.');
+            return c;
+    }
+}
+/** Whether a backend can target an element with the given selector strategy. */
+export function selectorSupported(caps, strategy) {
+    switch (strategy) {
+        case 'resource_id':
+            return caps.resourceId;
+        case 'accessibility_id':
+            return caps.accessibilityId;
+        case 'text':
+            return caps.textSelector;
+        case 'ios_predicate':
+            return caps.iosPredicate;
+        case 'ios_class_chain':
+            return caps.iosClassChain;
+        case 'ocr_text':
+            return caps.ocrFallback;
+        case 'image':
+            return caps.visualFallback;
+        case 'coordinate':
+            // Any backend that can screenshot can be driven by coordinate as a last resort.
+            return caps.screenshot;
+        default:
+            return false;
+    }
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/automation/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../src/automation/capabilities.ts"],"names":[],"mappings":"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"}