swipium 1.0.0

package/dist/drivers/WdaDriver.js

@@ -0,0 +1,250 @@
+import * as sim from '../lib/simctl.js';
+import { clearWdaElement, createWdaSession, deleteWdaSession, dragWdaPoint, findWdaElement, normalizeWdaSource, pressWdaBack, pressWdaHome, tapWdaElement, tapWdaPoint, typeWdaElement, wdaActiveAppInfo, wdaScreenshot, wdaSessionUdidMismatch, wdaSource, } from '../lib/wda.js';
+const UNSUPPORTED = 'not supported by the WDA backend yet.';
+function tailLines(text, lines) {
+    const all = text.split(/\r?\n/);
+    return all.slice(Math.max(0, all.length - lines)).join('\n');
+}
+export class WdaDriver {
+    kind = 'wda';
+    baseUrl;
+    simulator;
+    udid;
+    sessionId;
+    bundleId;
+    capabilities;
+    settings;
+    onTiming;
+    constructor(baseUrl, opts = {}) {
+        this.baseUrl = baseUrl.replace(/\/+$/, '');
+        this.simulator = opts.simulator ?? sim;
+        this.udid = opts.udid;
+        this.sessionId = opts.sessionId;
+        this.bundleId = opts.bundleId;
+        this.capabilities = opts.capabilities;
+        this.settings = opts.settings;
+        this.onTiming = opts.onTiming;
+    }
+    async timed(kind, fn) {
+        const started = Date.now();
+        try {
+            return await fn();
+        }
+        finally {
+            this.onTiming?.(kind, Date.now() - started);
+        }
+    }
+    async ensureSession() {
+        if (this.sessionId)
+            return this.sessionId;
+        const s = await this.timed('session_create', () => createWdaSession(this.baseUrl, { bundleId: this.bundleId, udid: this.udid, capabilities: this.capabilities, settings: this.settings }));
+        const mismatchedUdid = wdaSessionUdidMismatch(s.capabilities, this.udid);
+        if (mismatchedUdid) {
+            throw new Error(`STALE_WDA_DEVICE: WDA session is bound to ${mismatchedUdid}, not requested device ${this.udid}.`);
+        }
+        this.sessionId = s.sessionId;
+        return s.sessionId;
+    }
+    no(op) {
+        return Promise.reject(new Error(`${op} ${UNSUPPORTED}`));
+    }
+    listDevices() {
+        return Promise.resolve(this.udid ? [this.udid] : []);
+    }
+    useDevice(serial) {
+        this.udid = serial;
+    }
+    currentDevice() {
+        return this.udid;
+    }
+    currentSession() {
+        return this.sessionId;
+    }
+    async close() {
+        if (!this.sessionId)
+            return;
+        const sid = this.sessionId;
+        this.sessionId = undefined;
+        await deleteWdaSession(this.baseUrl, sid);
+    }
+    async installApp(appPath) {
+        if (!this.udid || !this.simulator.installApp)
+            return this.no('app install');
+        await this.simulator.installApp(this.udid, appPath);
+    }
+    async uninstallApp(pkg) {
+        if (!this.udid || !this.simulator.uninstallApp)
+            return this.no('app uninstall');
+        await this.simulator.uninstallApp(this.udid, pkg);
+    }
+    async isInstalled(pkg) {
+        const target = pkg || this.bundleId;
+        if (!target)
+            return false;
+        if (this.udid && this.simulator.isInstalled) {
+            return this.simulator.isInstalled(this.udid, target);
+        }
+        try {
+            const info = await wdaActiveAppInfo(this.baseUrl, this.sessionId ?? 'current');
+            return info.bundleId === target;
+        }
+        catch {
+            return false;
+        }
+    }
+    async isRunning(pkg) {
+        const target = pkg || this.bundleId;
+        if (!target)
+            return false;
+        try {
+            const info = await wdaActiveAppInfo(this.baseUrl, this.sessionId ?? 'current');
+            return info.bundleId === target;
+        }
+        catch {
+            return false;
+        }
+    }
+    async launchApp(pkg) {
+        this.bundleId = pkg;
+        if (this.udid) {
+            await this.simulator.launchApp(this.udid, pkg);
+        }
+        await this.ensureSession();
+    }
+    async launchAppWithArgs(pkg, args) {
+        this.bundleId = pkg;
+        if (this.udid && this.simulator.launchAppWithArgs) {
+            await this.simulator.launchAppWithArgs(this.udid, pkg, args);
+        }
+        else if (Object.keys(args).length) {
+            return this.no('launch arguments');
+        }
+        await this.ensureSession();
+    }
+    async terminateApp(pkg) {
+        const target = pkg || this.bundleId;
+        if (!this.udid || !target)
+            return this.no('app terminate');
+        await this.simulator.terminateApp(this.udid, target);
+    }
+    clearData() {
+        return this.no('clear app data');
+    }
+    imeShown() {
+        return Promise.resolve(false);
+    }
+    async logcat(lines = 200, grep) {
+        if (!this.udid)
+            return this.no('iOS simulator log capture without a simulator UDID');
+        const raw = await this.simulator.simulatorLogs(this.udid, { last: '5m', bundleId: this.bundleId });
+        const filtered = grep
+            ? raw.split(/\r?\n/).filter((line) => new RegExp(grep, 'i').test(line)).join('\n')
+            : raw;
+        return tailLines(filtered, lines);
+    }
+    airplaneOn() {
+        return this.no('airplane-mode read');
+    }
+    setAirplane() {
+        return this.no('airplane-mode toggle');
+    }
+    async foregroundOwner() {
+        try {
+            const info = await wdaActiveAppInfo(this.baseUrl, await this.ensureSession());
+            return info.bundleId ?? info.name ?? this.bundleId ?? 'unknown';
+        }
+        catch {
+            return this.bundleId ?? 'unknown';
+        }
+    }
+    async screenshot() {
+        const sid = await this.ensureSession();
+        return this.timed('screenshot', () => wdaScreenshot(this.baseUrl, sid));
+    }
+    async dumpXml() {
+        const sid = await this.ensureSession();
+        return normalizeWdaSource(await this.timed('source', () => wdaSource(this.baseUrl, sid)));
+    }
+    async tapXY(x, y) {
+        const sid = await this.ensureSession();
+        await this.timed('tap', () => tapWdaPoint(this.baseUrl, sid, x, y));
+    }
+    async pressXY(x, y) {
+        await this.tapXY(x, y);
+    }
+    async inputText(text) {
+        const sid = await this.ensureSession();
+        const el = await this.timed('find_element', () => findWdaElement(this.baseUrl, sid, 'predicate string', 'hasKeyboardFocus == 1'));
+        await this.timed('type', () => typeWdaElement(this.baseUrl, sid, el.elementId, text));
+    }
+    async clearFocusedText() {
+        const sid = await this.ensureSession();
+        const el = await this.timed('find_element', () => findWdaElement(this.baseUrl, sid, 'predicate string', 'hasKeyboardFocus == 1'));
+        await this.timed('clear', () => clearWdaElement(this.baseUrl, sid, el.elementId));
+    }
+    async pressKey(key) {
+        if (key === 'home') {
+            await pressWdaHome(this.baseUrl, await this.ensureSession());
+            return;
+        }
+        if (key === 'back') {
+            await pressWdaBack(this.baseUrl, await this.ensureSession());
+            return;
+        }
+        await this.inputText('\n');
+    }
+    async swipe(x1, y1, x2, y2, ms = 300) {
+        await dragWdaPoint(this.baseUrl, await this.ensureSession(), x1, y1, x2, y2, ms / 1000);
+    }
+    adbReverseMetro() {
+        return this.no('dev-server port reverse');
+    }
+    async screenSize() {
+        const xml = await this.dumpXml();
+        const m = xml.match(/bounds="\[0,0\]\[(\d+),(\d+)\]"/);
+        return m ? { width: Number(m[1]), height: Number(m[2]) } : null;
+    }
+    screenDensity() {
+        return Promise.resolve(null);
+    }
+    async openUrl(url) {
+        if (!this.udid)
+            return this.no('open url without a simulator UDID');
+        await this.simulator.openUrl(this.udid, url);
+    }
+    disableAnimations() {
+        return Promise.resolve();
+    }
+    async tapByAccessibilityId(value) {
+        await this.tapBySelector('accessibility id', value);
+    }
+    async typeByAccessibilityId(value, text) {
+        await this.typeBySelector('accessibility id', value, text);
+    }
+    async tapBySelector(using, value) {
+        const sid = await this.ensureSession();
+        const el = await this.timed('find_element', () => findWdaElement(this.baseUrl, sid, using, value));
+        await this.timed('tap', () => tapWdaElement(this.baseUrl, sid, el.elementId));
+    }
+    async typeBySelector(using, value, text) {
+        const sid = await this.ensureSession();
+        const el = await this.timed('find_element', () => findWdaElement(this.baseUrl, sid, using, value));
+        await this.timed('type', () => typeWdaElement(this.baseUrl, sid, el.elementId, text));
+    }
+    async clearBySelector(using, value) {
+        const sid = await this.ensureSession();
+        const el = await this.timed('find_element', () => findWdaElement(this.baseUrl, sid, using, value));
+        await this.timed('clear', () => clearWdaElement(this.baseUrl, sid, el.elementId));
+    }
+    async existsBySelector(using, value) {
+        const sid = await this.ensureSession();
+        try {
+            await this.timed('find_element', () => findWdaElement(this.baseUrl, sid, using, value));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=WdaDriver.js.map

package/dist/drivers/WdaDriver.js.map

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

package/dist/explore/candidates.js

@@ -0,0 +1,93 @@
+// Candidate action ranking (Phase 3.3 §8). From a parsed snapshot, produce ranked ExploreElements:
+// prioritize useful low-risk coverage (nav, tabs, named safe buttons, list items) and deprioritize
+// unlabeled icons + coordinate-only targets — which also surface as locator-quality issues. PURE.
+import { classifyRisk } from './policy.js';
+const NAV = /\b(home|tab|menu|settings?|search|explore|discover|profile|account|back|next|map|list|history|notifications?|messages?|dashboard|library|feed|overview)\b/i;
+function locatorFor(e) {
+    if (e.id)
+        return { strategy: 'id', value: e.id, durability: 'high' };
+    if (e.label)
+        return { strategy: 'accessibility', value: e.label, durability: 'high' };
+    if (e.text)
+        return { strategy: 'text', value: e.text, durability: 'medium' };
+    const c = bounds(e);
+    return { strategy: 'coordinate', value: `${Math.round(c.x + c.w / 2)},${Math.round(c.y + c.h / 2)}`, durability: 'low' };
+}
+function bounds(e) {
+    const [x1, y1, x2, y2] = e.bounds;
+    return { x: x1, y: y1, w: x2 - x1, h: y2 - y1 };
+}
+/** Priority score (higher = explore sooner). */
+function score(e, locator, risk) {
+    let s = 0;
+    const label = `${e.text ?? ''} ${e.label ?? ''} ${e.id ?? ''}`;
+    if (NAV.test(label))
+        s += 50; // navigation / tabs first
+    if (risk === 'safe')
+        s += 30;
+    if (risk === 'destructive')
+        s -= 200;
+    if (risk === 'unknown')
+        s -= 10;
+    // durable locators are worth more (and teach the suite better selectors)
+    s += locator.durability === 'high' ? 20 : locator.durability === 'medium' ? 8 : -15;
+    if (locator.strategy === 'coordinate')
+        s -= 20; // coordinate-only is brittle/low-value
+    if (e.text || e.label)
+        s += 10; // has a human handle
+    return s;
+}
+/** Rank the actionable elements of a parsed snapshot into explore candidates, best first. */
+export function rankCandidates(elements, opts = {}) {
+    const explored = opts.explored ?? new Set();
+    const out = [];
+    for (const e of elements) {
+        const editable = /EditText|Text[-_ ]?Field|TextInput|SearchView/i.test(e.role) || e.secure;
+        const actionType = editable ? 'type' : e.clickable ? 'tap' : 'tap';
+        if (editable && !opts.includeTextEntry)
+            continue; // no blind typing without a value source
+        if (!e.clickable && !editable)
+            continue; // only actionable elements
+        const locator = locatorFor(e);
+        const { risk, reason, riskClass, stepUp, requiresTwoStepConfirmation } = classifyRisk({ label: e.text || e.label, id: e.id, role: e.role });
+        const b = bounds(e);
+        const signatureKey = `${actionType}:${locator.strategy}:${locator.value}`;
+        if (explored.has(signatureKey))
+            continue;
+        out.push({
+            ref: e.ref,
+            label: e.text || e.label,
+            role: e.role,
+            bounds: b,
+            locator,
+            actionType,
+            secure: e.secure,
+            risk,
+            riskClass,
+            stepUp,
+            requiresTwoStepConfirmation,
+            reason,
+            score: score(e, locator, risk),
+            signatureKey,
+        });
+    }
+    return out.sort((a, b) => b.score - a.score);
+}
+/** Locator-readiness grade for a screen (Phase 3.3 §9.4) — drives the report's testability advice. */
+export function locatorQuality(elements) {
+    const actionable = elements.filter((e) => e.clickable);
+    if (actionable.length === 0)
+        return { grade: 'A', missingStableLocators: 0, coordinateOnlyTargets: 0 };
+    let stable = 0;
+    let coordinateOnly = 0;
+    for (const e of actionable) {
+        if (e.id || e.label)
+            stable++;
+        else if (!e.text)
+            coordinateOnly++;
+    }
+    const ratio = stable / actionable.length;
+    const grade = ratio >= 0.9 ? 'A' : ratio >= 0.7 ? 'B' : ratio >= 0.4 ? 'C' : 'D';
+    return { grade, missingStableLocators: actionable.length - stable, coordinateOnlyTargets: coordinateOnly };
+}
+//# sourceMappingURL=candidates.js.map

package/dist/explore/candidates.js.map

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

package/dist/explore/graph.js

@@ -0,0 +1,116 @@
+// Screen graph (Phase 3.3 Milestone B) — model exploration as nodes (screens) + edges (actions),
+// not free-form notes. Nodes dedupe by signature so revisiting Home collapses to one node while a
+// modal/sheet becomes a distinct node. PURE: serialization only; the runner drives it.
+export class ExploreGraph {
+    platform;
+    nodes = new Map(); // by signature
+    order = []; // insertion order of signatures
+    edges = [];
+    tasks = [];
+    hypotheses = [];
+    coverageClaims = [];
+    blockedPreconditions = [];
+    reflection;
+    rootId;
+    constructor(platform) {
+        this.platform = platform;
+    }
+    /** Add a node if its signature is new, else bump the existing node's visit count. Returns the node. */
+    upsert(node) {
+        const existing = this.nodes.get(node.signature);
+        if (existing) {
+            existing.visits++;
+            // Refresh evidence/health on revisit (latest wins) without losing identity.
+            if (node.screenshotUri)
+                existing.screenshotUri = node.screenshotUri;
+            existing.health = node.health;
+            return { node: existing, isNew: false };
+        }
+        const id = `s${this.order.length + 1}`;
+        const full = { ...node, id, visits: 1 };
+        this.nodes.set(node.signature, full);
+        this.order.push(node.signature);
+        if (!this.rootId)
+            this.rootId = id;
+        return { node: full, isNew: true };
+    }
+    /** Look up a node by its current signature (for "did the screen change?"). */
+    bySignature(signature) {
+        return this.nodes.get(signature);
+    }
+    addEdge(edge) {
+        this.edges.push(edge);
+    }
+    nodeCount() {
+        return this.nodes.size;
+    }
+    edgeCount() {
+        return this.edges.length;
+    }
+    allNodes() {
+        return this.order.map((sig) => this.nodes.get(sig));
+    }
+    allEdges() {
+        return [...this.edges];
+    }
+    setTasks(tasks) {
+        this.tasks = tasks;
+    }
+    setHypotheses(hypotheses) {
+        this.hypotheses = hypotheses;
+    }
+    setCoverageClaims(claims) {
+        this.coverageClaims = claims;
+    }
+    setBlockedPreconditions(blocked) {
+        this.blockedPreconditions = blocked;
+    }
+    setReflection(reflection) {
+        this.reflection = reflection;
+    }
+    serialize(generatedAt) {
+        return {
+            schemaVersion: 2,
+            generatedAt,
+            platform: this.platform,
+            nodes: this.allNodes(),
+            edges: this.edges,
+            rootId: this.rootId,
+            tasks: this.tasks,
+            hypotheses: this.hypotheses,
+            coverageClaims: this.coverageClaims,
+            blockedPreconditions: this.blockedPreconditions,
+            reflection: this.reflection,
+        };
+    }
+    /** Human-readable Markdown summary of the graph. */
+    toMarkdown(generatedAt) {
+        const out = [`# Exploration Screen Graph`, ``, `Generated: ${generatedAt} · platform: ${this.platform} · ${this.nodes.size} screens / ${this.edges.length} actions`, ``];
+        for (const n of this.allNodes()) {
+            out.push(`## ${n.id}${n.title ? ` — ${n.title}` : ''} (${n.mode})`, `- signature: \`${n.signature}\``, `- health: native ${n.health.native} · app ${n.health.app}${n.authState ? ` · auth ${n.authState}` : ''}`, ...(n.visualOnlyReason ? [`- visual-only: ${n.visualOnlyReason}`] : []), ...(n.locatorQuality ? [`- locator readiness: ${n.locatorQuality.grade} (${n.locatorQuality.missingStableLocators} missing stable, ${n.locatorQuality.coordinateOnlyTargets} coordinate-only)`] : []), ...(n.screenshotUri ? [`- screenshot: ${n.screenshotUri}`] : []), `- elements: ${n.elements.length} (${n.elements.filter((e) => e.risk === 'safe').length} safe, ${n.elements.filter((e) => e.risk === 'destructive').length} destructive)`, ``);
+        }
+        if (this.edges.length) {
+            out.push(`## Transitions`, ``);
+            for (const e of this.edges) {
+                out.push(`- ${e.from} —[${e.action.type} ${e.action.targetDescription}]→ ${e.to ?? '?'} (${e.outcome})`);
+            }
+        }
+        if (this.tasks.length) {
+            out.push('', '## Tasks', '');
+            for (const t of this.tasks)
+                out.push(`- ${t.id}: ${t.title} [${t.feature}] — ${t.status}`);
+        }
+        if (this.coverageClaims.length) {
+            out.push('', '## Feature Coverage', '');
+            for (const c of this.coverageClaims)
+                out.push(`- ${c.feature}: ${c.status} — ${c.reason}`);
+        }
+        if (this.reflection) {
+            out.push('', '## Reflection', '');
+            for (const r of this.reflection.reasons)
+                out.push(`- ${r}`);
+        }
+        return out.join('\n');
+    }
+}
+//# sourceMappingURL=graph.js.map

package/dist/explore/graph.js.map

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

package/dist/explore/memory.js

@@ -0,0 +1,35 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+function safeName(value) {
+    return value.trim().replace(/[^a-zA-Z0-9._-]+/g, '_').slice(0, 120) || 'unknown-app';
+}
+export function exploreHistoryPath(root, appId) {
+    return join(root, '.swipium', 'explore-history', `${safeName(appId ?? 'unknown-app')}.json`);
+}
+export function loadExploreMemory(root, appId) {
+    const path = exploreHistoryPath(root, appId);
+    if (!existsSync(path))
+        return { schemaVersion: 1, appId: appId ?? 'unknown-app', entries: [] };
+    try {
+        const parsed = JSON.parse(readFileSync(path, 'utf8'));
+        return {
+            schemaVersion: 1,
+            appId: parsed.appId ?? appId ?? 'unknown-app',
+            entries: Array.isArray(parsed.entries) ? parsed.entries : [],
+        };
+    }
+    catch {
+        return { schemaVersion: 1, appId: appId ?? 'unknown-app', entries: [] };
+    }
+}
+export function appendExploreMemory(root, appId, entry) {
+    const path = exploreHistoryPath(root, appId);
+    const memory = loadExploreMemory(root, appId);
+    memory.appId = appId ?? 'unknown-app';
+    memory.entries.push(entry);
+    memory.entries = memory.entries.slice(-50);
+    mkdirSync(join(root, '.swipium', 'explore-history'), { recursive: true });
+    writeFileSync(path, JSON.stringify(memory, null, 2));
+    return path;
+}
+//# sourceMappingURL=memory.js.map

package/dist/explore/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/explore/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AA0BjC,SAAS,QAAQ,CAAC,KAAa;IAC7B,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,aAAa,CAAC;AACvF,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,KAAc;IAC7D,OAAO,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,iBAAiB,EAAE,GAAG,QAAQ,CAAC,KAAK,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;AAC/F,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,KAAc;IAC5D,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC7C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,aAAa,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,IAAI,aAAa,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC/F,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAkB,CAAC;QACvE,OAAO;YACL,aAAa,EAAE,CAAC;YAChB,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,KAAK,IAAI,aAAa;YAC7C,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;SAC7D,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,aAAa,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,IAAI,aAAa,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC1E,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,KAAyB,EAAE,KAAyB;IACpG,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC9C,MAAM,CAAC,KAAK,GAAG,KAAK,IAAI,aAAa,CAAC;IACtC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;IAC3C,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,iBAAiB,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1E,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACrD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/explore/planner.js

@@ -0,0 +1,105 @@
+const FEATURE_RULES = [
+    { feature: 'navigation', re: /\b(home|tab|menu|back|next|details|open|view|dashboard|overview)\b/i, task: 'Exercise primary navigation', risk: 'safe' },
+    { feature: 'auth', re: /\b(sign in|log in|login|password|email|account|register|create account)\b/i, task: 'Reach and validate authentication', risk: 'unknown' },
+    { feature: 'search', re: /\b(search|filter|sort|find)\b/i, task: 'Search or filter content', risk: 'safe' },
+    { feature: 'create', re: /\b(add|new|create|compose|upload)\b/i, task: 'Create a new record', risk: 'unknown' },
+    { feature: 'edit', re: /\b(edit|update|rename|change|save)\b/i, task: 'Edit an existing record', risk: 'unknown' },
+    { feature: 'delete', re: /\b(delete|remove|clear|wipe|discard)\b/i, task: 'Discover delete flow without executing it', risk: 'destructive' },
+    { feature: 'share/send', re: /\b(share|send|invite|message|email)\b/i, task: 'Discover share or send flow without external side effects', risk: 'destructive' },
+    { feature: 'settings', re: /\b(settings|preferences|privacy|permissions)\b/i, task: 'Inspect settings', risk: 'safe' },
+    { feature: 'media', re: /\b(photo|camera|image|video|gallery|media)\b/i, task: 'Exercise media surface', risk: 'unknown' },
+    { feature: 'map/location', re: /\b(map|location|nearby|route|gps|address)\b/i, task: 'Exercise map or location surface', risk: 'unknown' },
+    { feature: 'purchase', re: /\b(pay|buy|purchase|checkout|subscribe|order)\b/i, task: 'Discover purchase flow without executing it', risk: 'destructive' },
+    { feature: 'profile', re: /\b(profile|account|avatar|bio|name)\b/i, task: 'Inspect profile workflow', risk: 'safe' },
+    { feature: 'notifications', re: /\b(notification|alert|bell|push)\b/i, task: 'Inspect notification workflow', risk: 'safe' },
+];
+export const FEATURE_KEYS = FEATURE_RULES.map((r) => r.feature);
+export function inferAppDomain(input) {
+    const hay = `${input.packageId ?? ''} ${input.goal ?? ''} ${input.screenText} ${input.fixtures.join(' ')}`.toLowerCase();
+    const matches = [
+        ['commerce', /\b(cart|checkout|order|price|product|shop|store)\b/],
+        ['messaging', /\b(chat|message|inbox|send|recipient)\b/],
+        ['travel', /\b(flight|booking|trip|hotel|map|route)\b/],
+        ['content', /\b(feed|post|article|media|video|photo)\b/],
+        ['productivity', /\b(note|task|todo|calendar|document)\b/],
+    ];
+    const found = matches.find(([, re]) => re.test(hay));
+    return { domain: found?.[0] ?? 'general_mobile_app', evidence: [input.packageId, input.goal].filter((x) => !!x) };
+}
+export function proposeTasks(input) {
+    const hay = `${input.goal ?? ''} ${input.screenText} ${input.candidates.map((c) => `${c.label ?? ''} ${c.locator?.value ?? ''}`).join(' ')}`;
+    const tasks = [];
+    for (const rule of FEATURE_RULES) {
+        if (!rule.re.test(hay))
+            continue;
+        const preconditions = [];
+        if (rule.feature === 'auth' && !input.fixtures.some((f) => /account|login|auth|credential/i.test(f)))
+            preconditions.push('test account credentials');
+        if (rule.risk === 'destructive')
+            preconditions.push('disposable test state');
+        tasks.push({
+            id: `task-${tasks.length + 1}`,
+            title: rule.task,
+            feature: rule.feature,
+            preconditions,
+            risk: rule.risk,
+            status: rule.risk === 'destructive' ? 'unsafe' : preconditions.length ? 'blocked' : 'proposed',
+        });
+    }
+    if (!tasks.length) {
+        tasks.push({ id: 'task-1', title: input.goal || 'Explore primary reachable workflow', feature: 'navigation', preconditions: [], risk: 'safe', status: 'proposed' });
+    }
+    return tasks;
+}
+export function estimateFeatureCoverage(nodes, tasks) {
+    const text = nodes
+        .flatMap((n) => [n.title, ...n.elements.flatMap((e) => [e.label, e.locator?.value, e.reason])])
+        .filter(Boolean)
+        .join(' ');
+    const out = Object.fromEntries(FEATURE_KEYS.map((k) => [k, 'not_found']));
+    for (const rule of FEATURE_RULES) {
+        if (rule.re.test(text))
+            out[rule.feature] = rule.risk === 'destructive' ? 'unsafe' : 'covered';
+    }
+    for (const task of tasks) {
+        if (task.status === 'blocked')
+            out[task.feature] = task.preconditions.some((p) => /fixture|account|credential|state/i.test(p)) ? 'needs_fixture' : 'blocked';
+        if (task.status === 'unsafe')
+            out[task.feature] = 'unsafe';
+        if (task.status === 'completed')
+            out[task.feature] = 'covered';
+    }
+    return out;
+}
+export function coverageClaimsFrom(features, nodes) {
+    return FEATURE_KEYS.map((feature) => {
+        const status = features[feature];
+        const evidence = nodes
+            .filter((n) => n.elements.some((e) => `${e.label ?? ''} ${e.locator?.value ?? ''}`.toLowerCase().includes(feature.split('/')[0].split('-')[0])))
+            .map((n) => n.id);
+        return {
+            feature,
+            status,
+            evidence,
+            reason: status === 'covered' ? 'reachable UI evidence was observed' : status === 'unsafe' ? 'only high-impact controls were found' : status === 'needs_fixture' ? 'requires declared test data or disposable state' : 'no strong feature signal observed',
+        };
+    });
+}
+export function reflectExploration(nodes, sameScreenEdges, reasons) {
+    const low = nodes.filter((n) => n.locatorQuality && ['C', 'D'].includes(n.locatorQuality.grade)).map((n) => n.id);
+    const shallowLoops = nodes.filter((n) => n.visits >= 3).map((n) => n.id);
+    const suiteReadiness = nodes.length > 1 && low.length === 0 ? 'candidate' : nodes.length > 1 ? 'rejected' : 'none';
+    return {
+        shallowLoops,
+        repeatedSameScreenActions: sameScreenEdges,
+        lowLocatorReadinessScreens: low,
+        suiteReadiness,
+        promotedPathCandidate: suiteReadiness === 'candidate' ? `${nodes[0]?.id ?? 's1'} -> ${nodes[nodes.length - 1]?.id ?? 's1'}` : undefined,
+        reasons: [
+            ...reasons,
+            low.length ? `${low.length} screen(s) need better locators before CI promotion` : 'locator readiness is acceptable for candidate suite promotion',
+            sameScreenEdges ? `${sameScreenEdges} action(s) did not change screen state` : 'no repeated same-screen action loop detected',
+        ],
+    };
+}
+//# sourceMappingURL=planner.js.map