swipium 1.0.1 → 1.2.0

package/dist/automation/plan.js

@@ -0,0 +1,268 @@
+// Automation Kernel V2 — Workstream 3: the Action Compiler. Compiles a Flow V2 file into Action IR,
+// then into a backend-specific automation plan WITHOUT touching a device. Every step is classified
+// before execution (native / supported_with_fallback / visual_only / unsupported) and unsupported
+// steps name the exact missing capability and a concrete next step. This is the pure core behind the
+// qa_flow_plan tool; it does not execute or mutate anything.
+import { selectorSupported } from './capabilities.js';
+import { checkSelectorBackend, parseSelector, selectorForCoordinate, selectorForVisual } from './selectors.js';
+import { gestureSupport } from './gestures.js';
+import { isVisualStrategy } from './types.js';
+/** Compile a single Flow V2 step into Action IR. Returns null for steps with no automation action. */
+export function compileStep(step) {
+    switch (step.kind) {
+        case 'tap':
+            return { kind: 'tap', selector: parseSelector(step.selector), expectedChange: 'unknown', note: step.selector };
+        case 'tapAt':
+            return { kind: 'tap', selector: selectorForCoordinate(`${step.x},${step.y}`), expectedChange: 'unknown', note: `tapAt ${step.x},${step.y}` };
+        case 'tapImage':
+            return { kind: 'tap', selector: selectorForVisual('image', step.template), expectedChange: 'unknown', note: `tapImage ${step.template}` };
+        case 'tapOcrText':
+            return { kind: 'tap', selector: selectorForVisual('ocr_text', step.query), expectedChange: 'unknown', note: `tapOcrText ${step.query}` };
+        case 'inputText':
+            return { kind: 'inputText', selector: step.into ? parseSelector(step.into) : undefined, text: step.value, note: step.into ?? '(focused field)' };
+        case 'assertVisible':
+            return { kind: 'assertVisible', selector: parseSelector(step.query), note: step.query };
+        case 'assertNotVisible':
+            return { kind: 'waitForNotVisible', selector: parseSelector(step.query), note: step.query };
+        case 'assertImage':
+            return { kind: 'assertVisual', selector: selectorForVisual('image', step.template), note: `assertImage ${step.template}` };
+        case 'assertOcrText':
+            return { kind: 'assertVisual', selector: selectorForVisual('ocr_text', step.query), note: `assertOcrText ${step.query}` };
+        case 'assertVisual':
+            return { kind: 'assertVisual', note: step.description };
+        case 'assertDiff':
+            return { kind: 'assertVisual', note: `assertDiff ${step.baseline}` };
+        case 'swipe': {
+            const gesture = { kind: 'swipe', direction: step.direction, area: step.area };
+            return { kind: 'swipe', gesture, note: `swipe ${step.direction}` };
+        }
+        case 'scrollTo': {
+            const selector = parseSelector(step.query);
+            const gesture = { kind: 'scroll', target: selector, direction: 'down', visibilityPercentage: 100 };
+            return { kind: 'scrollUntilVisible', selector, gesture, note: step.query };
+        }
+        case 'press':
+            return { kind: 'pressKey', text: step.key, note: `press ${step.key}` };
+        case 'openUrl':
+            return { kind: 'openUrl', text: step.url, note: step.url };
+        case 'waitForVisible':
+            return { kind: 'waitForVisible', selector: parseSelector(step.query), timeoutMs: step.timeoutMs, note: step.query };
+        case 'wait':
+            return step.query
+                ? { kind: 'waitForVisible', selector: parseSelector(step.query), note: step.query }
+                : { kind: 'waitForIdle', idleSource: 'heuristic', timeoutMs: step.ms, note: step.ms != null ? `wait ${step.ms}ms` : 'wait' };
+        case 'waitForIdle':
+            return { kind: 'waitForIdle', idleSource: 'heuristic', timeoutMs: step.timeoutMs, note: 'waitForIdle' };
+        // Lifecycle / environment / meta steps — modeled but not selector-targeted.
+        case 'prepareTarget':
+        case 'restartApp':
+        case 'clearOverlay':
+        case 'networkOffline':
+        case 'networkOnline':
+        case 'seed':
+        case 'note':
+        case 'screenshot':
+            return { kind: 'lifecycle', note: step.kind };
+        default:
+            return null;
+    }
+}
+/** Compile all of a flow's setup + main + teardown steps into Action IR. */
+export function compileActions(flow) {
+    return [...flow.setup, ...flow.steps, ...flow.teardown]
+        .map(compileStep)
+        .filter((a) => a != null);
+}
+const STRUCTURED_ACTIONS = new Set([
+    'tap', 'longPress', 'doubleTap', 'inputText', 'clearText', 'scrollUntilVisible',
+    'waitForVisible', 'waitForNotVisible', 'assertVisible',
+]);
+function hasNonAscii(text) {
+    if (!text)
+        return false;
+    for (let i = 0; i < text.length; i++)
+        if (text.charCodeAt(i) > 127)
+            return true;
+    return false;
+}
+/**
+ * Classify a text-input action's backend support. Returns a blocking Classification, or null when the
+ * input is fine. ASCII needs textInputAscii; literal non-ASCII text (e.g. "José") additionally needs
+ * textInputUnicode — adb `input text` cannot type Unicode reliably, so Android direct is blocked.
+ */
+function inputTextSupport(action, caps) {
+    if (!caps.textInputAscii)
+        return { support: 'unsupported', reason: `text input is unsupported on ${caps.backend}.`, requiredCapability: 'textInputAscii' };
+    if (hasNonAscii(action.text) && !caps.textInputUnicode) {
+        return {
+            support: 'unsupported',
+            reason: `text "${action.text}" contains non-ASCII characters; ${caps.backend} cannot input Unicode reliably.`,
+            requiredCapability: 'textInputUnicode',
+        };
+    }
+    return null;
+}
+function classifyAction(action, caps) {
+    // Lifecycle / control actions: available wherever lifecycle is (launch is our proxy).
+    if (action.kind === 'lifecycle' || action.kind === 'openUrl' || action.kind === 'pressKey') {
+        if (action.kind === 'openUrl' && !caps.openUrl) {
+            return { support: 'unsupported', reason: `openUrl is not supported on ${caps.backend}.`, requiredCapability: 'openUrl' };
+        }
+        return { support: 'native', reason: `${action.note ?? action.kind} runs as a lifecycle/control step on ${caps.backend}.` };
+    }
+    if (action.kind === 'waitForIdle') {
+        if (action.idleSource === 'app_declared' && !caps.appDeclaredIdling) {
+            return { support: 'supported_with_fallback', reason: `app-declared idling is unavailable on ${caps.backend}; will fall back to heuristic settling (not app proof).` };
+        }
+        return { support: 'native', reason: `waitForIdle uses ${caps.wdaIdling ? 'backend' : 'heuristic'} settling on ${caps.backend}.` };
+    }
+    if (action.kind === 'waitForAnimationToEnd') {
+        return { support: 'native', reason: `animation wait is honored heuristically on ${caps.backend}.` };
+    }
+    if (action.kind === 'swipe' && action.gesture) {
+        const g = gestureSupport(action.gesture, caps);
+        return g.supported
+            ? { support: 'native', reason: g.reason }
+            : { support: 'unsupported', reason: g.reason, requiredCapability: g.requiredCapability };
+    }
+    if (action.kind === 'pinch' || action.kind === 'drag' || action.kind === 'longPress' || action.kind === 'doubleTap') {
+        const g = gestureSupport(action.gesture ?? { kind: action.kind === 'pinch' ? 'pinch' : action.kind === 'drag' ? 'drag' : action.kind === 'longPress' ? 'longPress' : 'doubleTap' }, caps);
+        if (!g.supported && (STRUCTURED_ACTIONS.has(action.kind) || action.kind === 'pinch' || action.kind === 'drag')) {
+            return { support: 'unsupported', reason: g.reason, requiredCapability: g.requiredCapability };
+        }
+    }
+    const selector = action.selector;
+    // Visual-strategy targets are candidate evidence only.
+    if (selector && isVisualStrategy(selector.strategy)) {
+        const ok = selectorSupported(caps, selector.strategy);
+        return ok
+            ? { support: 'visual_only', reason: `${action.kind} uses a ${selector.strategy} target — visual/OCR candidate evidence, not a structured locator proof.` }
+            : { support: 'unsupported', reason: `${selector.strategy} fallback is unavailable on ${caps.backend}.`, requiredCapability: selector.strategy };
+    }
+    // assertVisual with no selector is always visual-only candidate evidence.
+    if (action.kind === 'assertVisual') {
+        return { support: 'visual_only', reason: 'assertVisual records visual candidate evidence; it is not a structured assertion.' };
+    }
+    // Coordinate targets work anywhere we can screenshot, but are a fallback (brittle).
+    if (selector && selector.strategy === 'coordinate') {
+        return selectorSupported(caps, 'coordinate')
+            ? { support: 'supported_with_fallback', reason: `${action.kind} by coordinate is a brittle fallback on ${caps.backend}; prefer a durable selector.` }
+            : { support: 'unsupported', reason: `coordinate targeting needs screenshot support on ${caps.backend}.`, requiredCapability: 'screenshot' };
+    }
+    // Structured selector actions: the backend must support the selector strategy.
+    if (selector && STRUCTURED_ACTIONS.has(action.kind)) {
+        const check = checkSelectorBackend(selector, caps);
+        if (!check.supported) {
+            // If the backend has no structured tree at all (e.g. iOS raw sim), surface the structural blocker.
+            if (!caps.structuredTree) {
+                return {
+                    support: 'unsupported',
+                    reason: `${caps.backend} cannot run structured ${action.kind}; ${check.detail}`,
+                    requiredCapability: 'structuredTree',
+                };
+            }
+            return { support: 'unsupported', reason: check.detail ?? `${selector.strategy} unsupported on ${caps.backend}.`, requiredCapability: selector.strategy };
+        }
+        // Text input also needs the right input capability (ASCII, and Unicode for non-ASCII text).
+        if (action.kind === 'inputText') {
+            const t = inputTextSupport(action, caps);
+            if (t)
+                return t;
+        }
+        return { support: 'native', reason: `${action.kind} via ${selector.strategy} is native on ${caps.backend}.` };
+    }
+    // inputText into the focused field (no selector).
+    if (action.kind === 'inputText') {
+        const t = inputTextSupport(action, caps);
+        if (t)
+            return t;
+        return { support: 'native', reason: `text input into the focused field is native on ${caps.backend}.` };
+    }
+    return { support: 'native', reason: `${action.kind} is supported on ${caps.backend}.` };
+}
+function nextStepForRequirement(requiredCapability, backend) {
+    switch (requiredCapability) {
+        case 'structuredTree':
+            return 'Attach WDA or Appium for structured selectors, or rewrite the step as a visual/OCR check.';
+        case 'pinch':
+            return 'Attach Appium UiAutomator2/XCUITest, or replace the pinch with a swipe/scroll.';
+        case 'textInputAscii':
+            return 'Use a backend that supports text input (WDA/Appium), or drive the field another way.';
+        case 'textInputUnicode':
+            return 'Use WDA or Appium for Unicode text, or change the fixture value to ASCII (adb input text cannot type Unicode reliably).';
+        case 'accessibility_id':
+        case 'resource_id':
+            return 'Attach a structured backend, or add a durable accessibility id / resource id.';
+        case 'ios_predicate':
+        case 'ios_class_chain':
+            return 'Use iOS WDA or Appium XCUITest, or replace it with an accessibility id.';
+        case 'ocr_text':
+        case 'image':
+            return 'Enable visual/OCR fallback, or attach a structured backend.';
+        default:
+            return `Attach a backend on which this step is supported (current: ${backend}).`;
+    }
+}
+/**
+ * Compile a Flow V2 file into a backend-specific automation plan. Pure — no device, no mutation.
+ */
+export function compileAutomationPlan(flow, caps) {
+    const actions = compileActions(flow);
+    const steps = [];
+    const blockers = [];
+    const warnings = [];
+    actions.forEach((action, index) => {
+        const cls = classifyAction(action, caps);
+        const step = { index, action, support: cls.support, reason: cls.reason, requiredCapability: cls.requiredCapability };
+        steps.push(step);
+        if (cls.support === 'unsupported') {
+            blockers.push({
+                code: cls.requiredCapability === 'structuredTree' ? 'BACKEND_UNSUPPORTED' : 'STEP_UNSUPPORTED',
+                detail: `step ${index} (${action.note ?? action.kind}): ${cls.reason}`,
+                nextStep: nextStepForRequirement(cls.requiredCapability, caps.backend),
+            });
+        }
+        else if (cls.support === 'visual_only') {
+            warnings.push({
+                code: 'VISUAL_ONLY',
+                detail: `step ${index} (${action.note ?? action.kind}): ${cls.reason}`,
+                nextStep: 'This is candidate-level evidence; add a structured selector for CI-grade proof.',
+            });
+        }
+        else if (cls.support === 'supported_with_fallback') {
+            warnings.push({
+                code: 'FALLBACK_USED',
+                detail: `step ${index} (${action.note ?? action.kind}): ${cls.reason}`,
+                nextStep: 'Prefer a durable selector to avoid the fallback.',
+            });
+        }
+    });
+    const executable = steps.every((s) => s.support !== 'unsupported');
+    const visualOnly = steps.filter((s) => s.support === 'visual_only').length;
+    const supported = steps.filter((s) => s.support === 'native' || s.support === 'supported_with_fallback').length;
+    const agentMessage = buildAgentMessage(caps.backend, executable, supported, visualOnly, blockers);
+    const developerMessage = buildDeveloperMessage(caps, steps, blockers, warnings);
+    return { backend: caps.backend, executable, steps, blockers, warnings, agentMessage, developerMessage };
+}
+function buildAgentMessage(backend, executable, supported, visualOnly, blockers) {
+    if (!executable) {
+        const first = blockers[0];
+        return `This flow is not runnable on ${backend}: ${first?.detail ?? 'an unsupported step blocks it'}. ${first?.nextStep ?? ''}`.trim();
+    }
+    if (supported === 0 && visualOnly > 0) {
+        return `This flow is candidate-only on ${backend}: ${visualOnly} visual/OCR step(s) and no structured locators. It produces candidate evidence, not structured proof.`;
+    }
+    const visualPart = visualOnly ? ` and ${visualOnly} visual fallback step(s)` : '';
+    return `This flow is runnable on ${backend} with ${supported} structured step(s)${visualPart}.`;
+}
+function buildDeveloperMessage(caps, steps, blockers, warnings) {
+    const lines = [`Backend: ${caps.backend}. ${steps.length} step(s) planned.`];
+    for (const b of blockers)
+        lines.push(`BLOCKER ${b.code}: ${b.detail} → ${b.nextStep}`);
+    for (const w of warnings)
+        lines.push(`WARNING ${w.code}: ${w.detail} → ${w.nextStep}`);
+    if (caps.notes.length)
+        lines.push(`Backend notes: ${caps.notes.join(' ')}`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=plan.js.map

package/dist/automation/plan.js.map

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

package/dist/automation/report.js

@@ -0,0 +1,83 @@
+// Automation Kernel V2 — Workstream 9: Automation Readiness Output. Turns an AutomationPlan into one
+// consistent response shape with natural-language messages a coding agent can repeat verbatim to the
+// user. The canonical phrases below match the plan's required wording for each backend/fallback case.
+import { isVisualStrategy } from './types.js';
+// Canonical phrases (plan Workstream 9 — "Required phrases").
+const PHRASE = {
+    iosRawSimulator: 'I can launch and inspect the app in the iOS simulator, but this backend cannot run structured taps. Attach WDA or Appium for selector-based automation.',
+    androidDirect: 'I can run this on Android using resource-id/accessibility/text selectors. Unicode text input needs a stronger backend or fixture adjustment.',
+    appiumRequired: 'This flow needs an Appium backend because it uses a WebView context or gesture that the current backend cannot perform.',
+    visualFallback: 'I can continue with visual/OCR evidence, but that is candidate-level evidence and not a structured locator proof.',
+};
+// Structured interaction/assertion kinds — the ones that produce structured-locator proof. Lifecycle
+// and control steps (openUrl, pressKey, waitForIdle, lifecycle) do NOT make a flow "ready" on their own.
+const STRUCTURED_PROOF_KINDS = new Set([
+    'tap', 'longPress', 'doubleTap', 'inputText', 'clearText', 'scrollUntilVisible',
+    'swipe', 'drag', 'pinch', 'waitForVisible', 'waitForNotVisible', 'assertVisible',
+]);
+function providesStructuredProof(step) {
+    if (step.support !== 'native' && step.support !== 'supported_with_fallback')
+        return false;
+    if (!STRUCTURED_PROOF_KINDS.has(step.action.kind))
+        return false;
+    const sel = step.action.selector;
+    if (sel && (isVisualStrategy(sel.strategy) || sel.strategy === 'coordinate'))
+        return false;
+    return true;
+}
+function statusFor(plan) {
+    if (!plan.executable)
+        return 'blocked';
+    const hasStructured = plan.steps.some(providesStructuredProof);
+    const hasVisualOnly = plan.steps.some((s) => s.support === 'visual_only');
+    if (!hasStructured && hasVisualOnly)
+        return 'candidate';
+    return 'ready';
+}
+function fallbackUsed(plan) {
+    if (plan.backend === 'ios-raw-simulator' && statusFor(plan) !== 'ready')
+        return 'ios-raw-simulator';
+    if (plan.blockers.some((b) => /appium|webview|context/i.test(`${b.detail} ${b.nextStep}`)))
+        return 'appium-required';
+    if (plan.steps.some((s) => s.support === 'visual_only'))
+        return 'visual-only';
+    return 'none';
+}
+function headlineFor(status, backend) {
+    const label = status === 'ready' ? 'Ready' : status === 'candidate' ? 'Candidate-only' : 'Blocked';
+    return `${label} on ${backend}`;
+}
+/** Build the natural-language agent message, preferring the plan's required canonical phrasing. */
+function agentMessageFor(plan, status) {
+    const fallback = fallbackUsed(plan);
+    const parts = [plan.agentMessage];
+    if (plan.backend === 'ios-raw-simulator' && status !== 'ready')
+        parts.push(PHRASE.iosRawSimulator);
+    if (plan.backend === 'android-direct')
+        parts.push(PHRASE.androidDirect);
+    if (fallback === 'appium-required')
+        parts.push(PHRASE.appiumRequired);
+    if (fallback === 'visual-only' || status === 'candidate')
+        parts.push(PHRASE.visualFallback);
+    // De-duplicate while preserving order.
+    return [...new Set(parts.filter(Boolean))].join(' ');
+}
+export function buildReadiness(plan) {
+    const status = statusFor(plan);
+    const supportedSteps = plan.steps.filter((s) => s.support !== 'unsupported').length;
+    const unsupportedSteps = plan.steps.filter((s) => s.support === 'unsupported').length;
+    return {
+        status,
+        headline: headlineFor(status, plan.backend),
+        agentMessage: agentMessageFor(plan, status),
+        developerMessage: plan.developerMessage,
+        backend: plan.backend,
+        supportedSteps,
+        unsupportedSteps,
+        blockers: plan.blockers,
+        warnings: plan.warnings,
+        fallbackUsed: fallbackUsed(plan),
+    };
+}
+export { PHRASE as READINESS_PHRASES };
+//# sourceMappingURL=report.js.map

package/dist/automation/report.js.map

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

package/dist/automation/selectors.js

@@ -0,0 +1,201 @@
+// Automation Kernel V2 — Workstream 2: Selector IR V2. One normalized selector model shared by
+// Flow V2, Maestro import/export, the Appium audit, and flow repair. Parses the existing Swipium
+// selector string grammar, normalizes Android resource ids, scores risk/portability, preserves
+// provenance, and refuses unsupported strategies per backend. NEVER generates XPath.
+import { selectorSupported } from './capabilities.js';
+import { isVisualStrategy } from './types.js';
+const PLATFORM_FOR_STRATEGY = {
+    resource_id: 'android',
+    ios_predicate: 'ios',
+    ios_class_chain: 'ios',
+};
+const PORTABLE_STRATEGIES = ['accessibility_id', 'text', 'ocr_text', 'image'];
+/** Normalize the many Android resource-id spellings to a bare id (last `/` segment). */
+export function normalizeResourceId(value) {
+    const trimmed = value.trim();
+    const slash = trimmed.lastIndexOf('/');
+    return slash >= 0 ? trimmed.slice(slash + 1) : trimmed;
+}
+function riskFor(strategy, value, hints) {
+    switch (strategy) {
+        case 'accessibility_id':
+        case 'resource_id':
+            return 'low';
+        case 'ios_predicate':
+        case 'ios_class_chain':
+            return 'medium';
+        case 'text': {
+            // Plain text is CI-brittle (copy/localization). Stable structural hints lower the risk.
+            const hasStableHint = !!(hints?.boundsBucket || hints?.screenSignature || hints?.className);
+            return hasStableHint ? 'medium' : 'high';
+        }
+        case 'ocr_text':
+        case 'image':
+            return 'high';
+        case 'coordinate':
+            return 'high';
+        default:
+            return 'high';
+    }
+}
+/**
+ * Parse one Swipium selector string into Selector IR. Recognizes the existing grammar:
+ *   `id=foo`, `id/foo`, `com.example:id/foo`, `accessibility id=foo`, `name=foo`,
+ *   `predicate string=...`, `class chain=...`, and bare text.
+ * OCR / image selectors come from dedicated flow steps, not this string grammar — see selectorForVisual().
+ */
+export function parseSelector(raw, opts = {}) {
+    const source = opts.source ?? 'flow';
+    const hints = opts.hints;
+    const s = raw.trim();
+    const make = (strategy, value) => ({
+        strategy,
+        value,
+        platform: opts.platform ?? PLATFORM_FOR_STRATEGY[strategy] ?? 'cross_platform',
+        source,
+        hints,
+        risk: riskFor(strategy, value, hints),
+        portable: PORTABLE_STRATEGIES.includes(strategy),
+    });
+    let m;
+    if ((m = s.match(/^id\s*=\s*(.+)$/i)))
+        return make('resource_id', normalizeResourceId(m[1]));
+    if ((m = s.match(/^accessibility id\s*=\s*(.+)$/i)))
+        return make('accessibility_id', m[1].trim());
+    if ((m = s.match(/^name\s*=\s*(.+)$/i)))
+        return make('text', m[1].trim());
+    if ((m = s.match(/^predicate string\s*=\s*(.+)$/i)))
+        return make('ios_predicate', m[1].trim());
+    if ((m = s.match(/^class chain\s*=\s*(.+)$/i)))
+        return make('ios_class_chain', m[1].trim());
+    // `com.example:id/foo` or `id/foo` without an explicit `id=` prefix is still an Android resource id.
+    if (/^[\w.]*:id\//.test(s) || /^id\//.test(s))
+        return make('resource_id', normalizeResourceId(s));
+    return make('text', s);
+}
+/** Build a visual (OCR/image) Selector IR from a dedicated visual flow step. */
+export function selectorForVisual(strategy, value, opts = {}) {
+    return {
+        strategy,
+        value,
+        platform: 'cross_platform',
+        source: opts.source ?? 'flow',
+        hints: opts.hints,
+        risk: 'high',
+        portable: true,
+    };
+}
+/** A coordinate selector (tapAt) — always last-resort, non-portable, high risk. */
+export function selectorForCoordinate(value, source = 'flow') {
+    return { strategy: 'coordinate', value, platform: 'cross_platform', source, risk: 'high', portable: false };
+}
+/** Refuse selectors a backend cannot honor (e.g. an iOS predicate on Android DirectDriver). */
+export function checkSelectorBackend(ir, caps) {
+    if (selectorSupported(caps, ir.strategy))
+        return { supported: true };
+    return {
+        supported: false,
+        code: 'BACKEND_UNSUPPORTED',
+        detail: `${ir.strategy} selector is not supported on ${caps.backend}.`,
+        nextStep: nextStepForUnsupportedSelector(ir.strategy, caps),
+    };
+}
+function nextStepForUnsupportedSelector(strategy, caps) {
+    if (strategy === 'ios_predicate' || strategy === 'ios_class_chain') {
+        return 'Use an iOS WDA or Appium XCUITest backend, or replace it with an accessibility id.';
+    }
+    if ((strategy === 'accessibility_id' || strategy === 'resource_id' || strategy === 'text') && !caps.structuredTree) {
+        return 'Attach WDA or Appium for structured selectors, or rewrite the step as a visual/OCR check.';
+    }
+    return `Attach a backend that supports ${strategy}.`;
+}
+/** CI-readiness check: plain text without stable hints is high risk and flagged. */
+export function checkSelectorCiRisk(ir) {
+    if (ir.strategy === 'text' && ir.risk === 'high') {
+        return {
+            risk: 'high',
+            code: 'HIGH_RISK_SELECTOR',
+            detail: 'Plain-text selector with no stable hints is brittle under copy/localization changes.',
+            nextStep: 'Pair it with a stable accessibility id / resource id, or add structural hints (boundsBucket, screenSignature).',
+        };
+    }
+    return { risk: ir.risk };
+}
+/**
+ * Resolve a (resource_id | accessibility_id) selector against parsed candidates. Duplicate matches
+ * are AMBIGUOUS_SELECTOR unless the IR's hints (boundsBucket / screenSignature) disambiguate to one.
+ */
+export function resolveSelector(ir, candidates) {
+    const key = (c) => ir.strategy === 'resource_id' ? (c.resourceId ? normalizeResourceId(c.resourceId) : undefined)
+        : ir.strategy === 'accessibility_id' ? c.accessibilityId
+            : ir.strategy === 'text' ? c.text
+                : undefined;
+    let matches = candidates.filter((c) => key(c) === ir.value);
+    if (matches.length === 0) {
+        return { ok: false, code: 'SELECTOR_NOT_FOUND', detail: `No element matches ${ir.strategy}=${ir.value}.`, matches: 0 };
+    }
+    if (matches.length === 1)
+        return { ok: true, match: matches[0] };
+    // Try to disambiguate by hints.
+    if (ir.hints?.boundsBucket) {
+        const narrowed = matches.filter((c) => c.boundsBucket === ir.hints.boundsBucket);
+        if (narrowed.length === 1)
+            return { ok: true, match: narrowed[0] };
+        if (narrowed.length)
+            matches = narrowed;
+    }
+    if (ir.hints?.screenSignature) {
+        const narrowed = matches.filter((c) => c.screenSignature === ir.hints.screenSignature);
+        if (narrowed.length === 1)
+            return { ok: true, match: narrowed[0] };
+    }
+    return {
+        ok: false,
+        code: 'AMBIGUOUS_SELECTOR',
+        detail: `${matches.length} elements match ${ir.strategy}=${ir.value}; add a disambiguating hint (boundsBucket/screenSignature) or a unique testID.`,
+        matches: matches.length,
+    };
+}
+/**
+ * Export a Selector IR to an Appium native locator strategy. NEVER returns XPath — visual/coordinate
+ * strategies have no Appium native locator and return null (the caller must mark them manual_review).
+ */
+export function selectorToAppium(ir) {
+    switch (ir.strategy) {
+        case 'resource_id':
+            return { using: 'id', value: ir.value };
+        case 'accessibility_id':
+            return { using: 'accessibility id', value: ir.value };
+        case 'ios_predicate':
+            return { using: '-ios predicate string', value: ir.value };
+        case 'ios_class_chain':
+            return { using: '-ios class chain', value: ir.value };
+        case 'text':
+            // Prefer a UiAutomator native text matcher over XPath for Android.
+            return { using: '-android uiautomator', value: `new UiSelector().text("${ir.value.replace(/"/g, '\\"')}")` };
+        default:
+            return null;
+    }
+}
+/** Convert a Maestro selector block (string | { id|text|... }) to Selector IR without semantic loss. */
+export function selectorFromMaestro(value, source = 'maestro_import') {
+    if (typeof value === 'string')
+        return parseSelector(value, { source });
+    if (!value || typeof value !== 'object')
+        return null;
+    const v = value;
+    if (typeof v.id === 'string')
+        return parseSelector(`id=${v.id}`, { source });
+    if (typeof v['accessibility id'] === 'string')
+        return parseSelector(`accessibility id=${v['accessibility id']}`, { source });
+    if (typeof v.label === 'string')
+        return parseSelector(`accessibility id=${v.label}`, { source });
+    if (typeof v.text === 'string')
+        return parseSelector(v.text, { source });
+    return null;
+}
+/** True when the strategy is a structured (non-visual) locator. */
+export function isStructuredSelector(ir) {
+    return !isVisualStrategy(ir.strategy) && ir.strategy !== 'coordinate';
+}
+//# sourceMappingURL=selectors.js.map

package/dist/automation/selectors.js.map

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

package/dist/automation/types.js

@@ -0,0 +1,13 @@
+// Automation Kernel V2 — shared types (Developer 3 lane). A backend-neutral automation model that
+// lets a Flow V2 file be compiled into a deterministic, capability-checked plan *before* a device
+// is touched. Everything here is pure data: no I/O, no driver calls. The runner, the planning
+// tools, Maestro interop, and the Appium audit all share these types so "the same flow means the
+// same thing" regardless of backend.
+//
+// See SWIPIUM-DEVELOPER-3-AUTOMATION-KERNEL-V2-PLAN-2026-05-29.md (Workstreams 1-5, 9).
+/** Visual selector strategies never claim structured-locator proof; they are candidate evidence only. */
+export const VISUAL_STRATEGIES = ['ocr_text', 'image'];
+export function isVisualStrategy(strategy) {
+    return VISUAL_STRATEGIES.includes(strategy);
+}
+//# sourceMappingURL=types.js.map

package/dist/automation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/automation/types.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,kGAAkG;AAClG,8FAA8F;AAC9F,iGAAiG;AACjG,qCAAqC;AACrC,EAAE;AACF,wFAAwF;AA0CxF,yGAAyG;AACzG,MAAM,CAAC,MAAM,iBAAiB,GAAgC,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AAEpF,MAAM,UAAU,gBAAgB,CAAC,QAA0B;IACzD,OAAO,iBAAiB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC9C,CAAC"}