swipium 1.0.0

package/dist/automationGen/pythonEmitter.js

@@ -0,0 +1,386 @@
+// SWIPIUM-REQ-04 — Python Appium emitter. Pure: turns the shared Appium model into a runnable
+// Python Appium-Python-Client POM suite (pytest when the project uses it, else unittest). POM
+// classes centralize selectors; AppiumBy strategies prefer accessibility id / id; iOS predicate /
+// class-chain only where required; XPath is never emitted. Aligns with the Appium Python quickstart.
+const DEFAULT_TIMEOUT = 15;
+function snake(s) {
+    return s
+        .replace(/([a-z0-9])([A-Z])/g, '$1_$2')
+        .replace(/[^A-Za-z0-9]+/g, '_')
+        .replace(/^_+|_+$/g, '')
+        .toLowerCase() || 'x';
+}
+/** Env var (SWIPIUM_TEST_PASSWORD) → a stable test_data key (password). */
+export function pyVarToKey(v) {
+    const stripped = v.replace(/^SWIPIUM_(TEST_)?/i, '');
+    return snake(stripped) || 'value';
+}
+function pyStr(s) {
+    return JSON.stringify(s);
+}
+/** (AppiumBy.<X>, "<value>") tuple for one Appium locator. No XPath, ever. */
+export function appiumByTuple(loc) {
+    switch (loc.strategy) {
+        case 'accessibilityId':
+            return `(AppiumBy.ACCESSIBILITY_ID, ${pyStr(loc.value)})`;
+        case 'id':
+            return `(AppiumBy.ID, ${pyStr(loc.value)})`;
+        case 'androidUiautomator':
+            return `(AppiumBy.ANDROID_UIAUTOMATOR, ${pyStr(`new UiSelector().text("${loc.value.replace(/"/g, '\\"')}")`)})`;
+        case 'name':
+            return `(AppiumBy.IOS_PREDICATE, ${pyStr(`name == "${loc.value.replace(/"/g, '\\"')}" OR label == "${loc.value.replace(/"/g, '\\"')}"`)})`;
+        case 'iosPredicate':
+            return `(AppiumBy.IOS_PREDICATE, ${pyStr(loc.value)})`;
+        case 'iosClassChain':
+            return `(AppiumBy.IOS_CLASS_CHAIN, ${pyStr(loc.value)})`;
+        case 'coordinate':
+            return undefined;
+        default:
+            return undefined;
+    }
+}
+function locatorDict(el) {
+    const parts = [];
+    if (el.android) {
+        const t = appiumByTuple(el.android);
+        if (t)
+            parts.push(`"android": ${t}`);
+    }
+    if (el.ios) {
+        const t = appiumByTuple(el.ios);
+        if (t)
+            parts.push(`"ios": ${t}`);
+    }
+    if (el.fallback && el.fallback.strategy === 'coordinate')
+        parts.push(`"coordinate": ${pyStr(el.fallback.value)}`);
+    else if (el.fallback && !el.android && !el.ios) {
+        const t = appiumByTuple(el.fallback);
+        if (t)
+            parts.push(`"android": ${t}`);
+    }
+    return `{${parts.join(', ')}}`;
+}
+export function emitPythonSuite(input) {
+    const files = [];
+    files.push({ path: 'requirements.txt', content: requirementsTxt(input) });
+    if (input.framework === 'pytest')
+        files.push({ path: 'pytest.ini', content: pytestIni() });
+    files.push({ path: 'conftest.py', content: conftest(input) });
+    files.push({ path: 'screens/__init__.py', content: '' });
+    files.push({ path: 'screens/base_screen.py', content: baseScreen() });
+    for (const screen of input.model.screens) {
+        files.push({ path: `screens/${snake(screen.className)}.py`, content: screenClass(screen, input.model.steps) });
+    }
+    files.push({ path: 'data/__init__.py', content: '' });
+    files.push({ path: 'data/test_data.py', content: testData(input.model) });
+    files.push({ path: 'tests/__init__.py', content: '' });
+    files.push({
+        path: input.framework === 'pytest' ? 'tests/test_smoke.py' : 'tests/test_smoke.py',
+        content: input.framework === 'pytest' ? pytestSmoke(input.model) : unittestSmoke(input.model, input),
+    });
+    return files;
+}
+function requirementsTxt(input) {
+    const lines = ['# Generated by Swipium — review before committing.', 'Appium-Python-Client>=4.0.0', 'selenium>=4.20.0'];
+    if (input.framework === 'pytest')
+        lines.push('pytest>=8.0.0');
+    return lines.join('\n') + '\n';
+}
+function pytestIni() {
+    return `# Generated by Swipium.
+[pytest]
+testpaths = tests
+python_files = test_*.py
+addopts = -ra
+`;
+}
+function conftest(input) {
+    const appId = input.appId ?? '';
+    return `# Generated by Swipium. Appium driver fixture — ALL device/app config is environment-driven.
+# Android UiAutomator2 is the default fast-feedback backend; set SWIPIUM_PLATFORM=ios for XCUITest.
+import os
+import pytest
+from appium import webdriver
+from appium.options.android import UiAutomator2Options
+from appium.options.ios import XCUITestOptions
+
+
+def build_options():
+    platform = os.environ.get("SWIPIUM_PLATFORM", "${input.model.platforms.android ? 'android' : 'ios'}").lower()
+    if platform == "ios":
+        opts = XCUITestOptions()
+        opts.device_name = os.environ.get("IOS_DEVICE_NAME", "iPhone 15")
+        bundle_id = os.environ.get("IOS_BUNDLE_ID"${appId ? `, ${pyStr(appId)}` : ''})
+        if bundle_id:
+            opts.bundle_id = bundle_id
+        if os.environ.get("IOS_APP_PATH"):
+            opts.app = os.environ["IOS_APP_PATH"]
+        if os.environ.get("IOS_UDID"):
+            opts.udid = os.environ["IOS_UDID"]
+        opts.no_reset = os.environ.get("SWIPIUM_NO_RESET") == "true"
+        return opts
+    opts = UiAutomator2Options()
+    opts.device_name = os.environ.get("ANDROID_DEVICE_NAME", "Android Emulator")
+    app_package = os.environ.get("ANDROID_APP_PACKAGE"${appId ? `, ${pyStr(appId)}` : ''})
+    if app_package:
+        opts.app_package = app_package
+    if os.environ.get("ANDROID_APP_ACTIVITY"):
+        opts.app_activity = os.environ["ANDROID_APP_ACTIVITY"]
+    if os.environ.get("ANDROID_APP_PATH"):
+        opts.app = os.environ["ANDROID_APP_PATH"]
+    if os.environ.get("ANDROID_UDID"):
+        opts.udid = os.environ["ANDROID_UDID"]
+    opts.no_reset = os.environ.get("SWIPIUM_NO_RESET") == "true"
+    return opts
+
+
+@pytest.fixture
+def driver():
+    url = os.environ.get("APPIUM_URL", "http://127.0.0.1:4723")
+    drv = webdriver.Remote(url, options=build_options())
+    yield drv
+    drv.quit()
+`;
+}
+function baseScreen() {
+    return `# Generated by Swipium. BaseScreen centralizes element interaction so selectors resolve
+# per-platform in ONE place and tests never touch raw selectors.
+from appium.webdriver.common.appiumby import AppiumBy  # noqa: F401  (used by screen subclasses)
+from selenium.webdriver.support.ui import WebDriverWait
+from selenium.webdriver.support import expected_conditions as EC
+
+DEFAULT_TIMEOUT = ${DEFAULT_TIMEOUT}
+
+
+class BaseScreen:
+    def __init__(self, driver):
+        self.driver = driver
+
+    def _spec(self, loc):
+        platform = (self.driver.capabilities.get("platformName") or "").lower()
+        spec = loc.get("ios") if platform == "ios" else loc.get("android")
+        if not spec:
+            raise RuntimeError(
+                "No durable selector for this platform — element relies on a coordinate fallback "
+                "(non-release-grade). Add an accessibility id / resource-id / testID."
+            )
+        return spec
+
+    def find(self, loc, timeout=DEFAULT_TIMEOUT):
+        by, value = self._spec(loc)
+        return WebDriverWait(self.driver, timeout).until(
+            EC.presence_of_element_located((by, value))
+        )
+
+    def tap(self, loc):
+        self.find(loc).click()
+
+    def type(self, loc, value):
+        el = self.find(loc)
+        el.clear()
+        el.send_keys(value)
+
+    def scroll_to(self, loc):
+        # Best-effort scroll; Appium resolves visibility on find.
+        self.find(loc)
+
+    def is_visible(self, loc):
+        try:
+            return self.find(loc).is_displayed()
+        except Exception:
+            return False
+
+    def assert_visible(self, loc):
+        assert self.find(loc).is_displayed()
+
+    def assert_text_visible(self, text):
+        # Non-release-grade text assertion — prefer a structured locator.
+        spec = (AppiumBy.ANDROID_UIAUTOMATOR, 'new UiSelector().textContains("%s")' % text)
+        assert WebDriverWait(self.driver, DEFAULT_TIMEOUT).until(
+            EC.presence_of_element_located(spec)
+        ).is_displayed()
+
+    def tap_at(self, x, y):
+        # Coordinate tap — brittle, non-release-grade fallback.
+        self.driver.tap([(x, y)])
+
+    def press_key(self, key):
+        if key == "back":
+            self.driver.back()
+
+    def open_url(self, url):
+        self.driver.get(url)
+`;
+}
+function methodName(action, element) {
+    const e = snake(element);
+    switch (action) {
+        case 'tap':
+            return `tap_${e}`;
+        case 'inputText':
+            return `enter_${e}`;
+        case 'scrollTo':
+            return `scroll_to_${e}`;
+        case 'assertVisible':
+            return `assert_${e}_visible`;
+        default:
+            return `act_${e}`;
+    }
+}
+function screenClass(screen, steps) {
+    const lines = [];
+    lines.push(`# Generated by Swipium. Screen object for ${screen.pageName}${screen.screenSignature ? ` (${screen.screenSignature})` : ''}.`);
+    lines.push('from appium.webdriver.common.appiumby import AppiumBy');
+    lines.push('from .base_screen import BaseScreen');
+    lines.push('');
+    lines.push('');
+    lines.push(`class ${screen.className}(BaseScreen):`);
+    if (screen.elements.length === 0)
+        lines.push('    pass');
+    for (const el of screen.elements) {
+        const note = el.durability === 'durable' ? '' : `  # ${el.durability}${el.remediation ? ` — ${el.remediation}` : ''}`;
+        lines.push(`    ${snake(el.name)} = ${locatorDict(el)}${note}`);
+    }
+    if (screen.elements.length)
+        lines.push('');
+    const seen = new Set();
+    for (const s of steps) {
+        if (s.screen !== screen.className || !s.element)
+            continue;
+        const el = screen.elements.find((e) => e.name === s.element);
+        if (!el)
+            continue;
+        const name = methodName(s.action, s.element);
+        if (seen.has(name))
+            continue;
+        seen.add(name);
+        const attr = snake(s.element);
+        if (s.action === 'inputText') {
+            lines.push(`    def ${name}(self, value):`);
+            lines.push(`        self.type(self.${attr}, value)`);
+            lines.push('');
+        }
+        else if (s.action === 'tap') {
+            lines.push(`    def ${name}(self):`);
+            lines.push(`        self.tap(self.${attr})`);
+            lines.push('');
+        }
+        else if (s.action === 'scrollTo') {
+            lines.push(`    def ${name}(self):`);
+            lines.push(`        self.scroll_to(self.${attr})`);
+            lines.push('');
+        }
+        else if (s.action === 'assertVisible') {
+            lines.push(`    def ${name}(self):`);
+            lines.push(`        self.assert_visible(self.${attr})`);
+            lines.push('');
+        }
+    }
+    return lines.join('\n').replace(/\n+$/, '\n');
+}
+function testData(model) {
+    const lines = [];
+    lines.push('# Generated by Swipium. Test data comes from the ENVIRONMENT — secrets are never inlined.');
+    lines.push('import os');
+    lines.push('');
+    lines.push('test_data = {');
+    for (const v of model.variables)
+        lines.push(`    ${pyStr(pyVarToKey(v))}: os.environ.get(${pyStr(v)}, ""),`);
+    for (const v of model.secrets)
+        lines.push(`    ${pyStr(pyVarToKey(v))}: os.environ.get(${pyStr(v)}, ""),  # secret — environment only`);
+    lines.push('}');
+    return lines.join('\n') + '\n';
+}
+function importsForTest(model) {
+    const classes = [...new Set(model.steps.map((s) => s.screen))];
+    return classes.map((c) => `from screens.${snake(c)} import ${c}`);
+}
+function stepCall(screenVar, s) {
+    if (s.element) {
+        const name = methodName(s.action, s.element);
+        if (s.action === 'inputText') {
+            const arg = s.varName ? `test_data[${pyStr(pyVarToKey(s.varName))}]` : pyStr(s.text ?? '');
+            return `${screenVar}.${name}(${arg})`;
+        }
+        return `${screenVar}.${name}()`;
+    }
+    switch (s.action) {
+        case 'tapAt':
+            return `${screenVar}.tap_at(${s.coords?.[0] ?? 0}, ${s.coords?.[1] ?? 0})  # coordinate fallback — non-release-grade`;
+        case 'inputText': {
+            const arg = s.varName ? `test_data[${pyStr(pyVarToKey(s.varName))}]` : pyStr(s.text ?? '');
+            return `${screenVar}.type({"android": (AppiumBy.ACCESSIBILITY_ID, "")}, ${arg})  # focused-field input`;
+        }
+        case 'press':
+            return `${screenVar}.press_key(${pyStr(s.key ?? 'back')})`;
+        case 'swipe':
+            return `${screenVar}.driver.swipe(0, 0, 0, 0)  # swipe ${s.direction ?? 'up'} — adjust coordinates`;
+        case 'openUrl':
+            return `${screenVar}.open_url(${pyStr(s.url ?? '')})`;
+        case 'assertVisible':
+            return `${screenVar}.assert_text_visible(${pyStr(s.text ?? '')})`;
+        default:
+            return `pass  # unsupported step: ${s.action}`;
+    }
+}
+function instanceVars(model) {
+    const classes = [...new Set(model.steps.map((s) => s.screen))];
+    const m = new Map();
+    for (const c of classes)
+        m.set(c, snake(c));
+    return m;
+}
+function pytestSmoke(model) {
+    const lines = [];
+    lines.push('# Generated by Swipium. Smoke test driving the recorded flow through the screen objects.');
+    lines.push(...importsForTest(model));
+    lines.push('from data.test_data import test_data  # noqa: F401');
+    const usesFocused = model.steps.some((s) => !s.element && s.action === 'inputText');
+    if (usesFocused)
+        lines.push('from appium.webdriver.common.appiumby import AppiumBy  # noqa: F401');
+    lines.push('');
+    lines.push('');
+    lines.push('def test_smoke(driver):');
+    const inst = instanceVars(model);
+    for (const [c, v] of inst)
+        lines.push(`    ${v} = ${c}(driver)`);
+    for (const s of model.steps)
+        lines.push(`    ${stepCall(inst.get(s.screen), s)}`);
+    return lines.join('\n') + '\n';
+}
+function unittestSmoke(model, input) {
+    const lines = [];
+    lines.push('# Generated by Swipium. Smoke test (unittest) driving the recorded flow through screen objects.');
+    lines.push('import os');
+    lines.push('import unittest');
+    lines.push('from appium import webdriver');
+    lines.push('from conftest import build_options');
+    lines.push(...importsForTest(model));
+    lines.push('from data.test_data import test_data  # noqa: F401');
+    const usesFocused = model.steps.some((s) => !s.element && s.action === 'inputText');
+    if (usesFocused)
+        lines.push('from appium.webdriver.common.appiumby import AppiumBy  # noqa: F401');
+    lines.push('');
+    lines.push('');
+    lines.push('class SmokeTest(unittest.TestCase):');
+    lines.push('    def setUp(self):');
+    lines.push('        url = os.environ.get("APPIUM_URL", "http://127.0.0.1:4723")');
+    lines.push('        self.driver = webdriver.Remote(url, options=build_options())');
+    lines.push('');
+    lines.push('    def tearDown(self):');
+    lines.push('        if self.driver:');
+    lines.push('            self.driver.quit()');
+    lines.push('');
+    lines.push('    def test_smoke(self):');
+    const inst = instanceVars(model);
+    for (const [c, v] of inst)
+        lines.push(`        ${v} = ${c}(self.driver)`);
+    for (const s of model.steps)
+        lines.push(`        ${stepCall(inst.get(s.screen), s)}`);
+    lines.push('');
+    lines.push('');
+    lines.push('if __name__ == "__main__":');
+    lines.push('    unittest.main()');
+    return lines.join('\n') + '\n';
+}
+//# sourceMappingURL=pythonEmitter.js.map

package/dist/automationGen/pythonEmitter.js.map

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

package/dist/automationGen/readmeEmitter.js

@@ -0,0 +1,66 @@
+// SWIPIUM-REQ-04 — README emitter. Pure: documents the generated suite, the required environment
+// variables (app id/path, device, Appium host/port, credentials, test data), and the exact run
+// commands. Honest about platform coverage and non-release-grade fallbacks.
+function envTable(model, isPython) {
+    const common = [
+        '| `APPIUM_HOST` / `APPIUM_PORT`' + (isPython ? ' / `APPIUM_URL`' : '') + ' | Appium server location (default 127.0.0.1:4723) |',
+        '| `SWIPIUM_PLATFORM` | `android` (default) or `ios` |',
+        '| `ANDROID_DEVICE_NAME`, `ANDROID_APP_PACKAGE`, `ANDROID_APP_ACTIVITY`, `ANDROID_APP_PATH`, `ANDROID_UDID` | Android target/app |',
+        '| `IOS_DEVICE_NAME`, `IOS_BUNDLE_ID`, `IOS_APP_PATH`, `IOS_UDID` | iOS target/app (when SWIPIUM_PLATFORM=ios) |',
+    ];
+    const data = model.variables.map((v) => `| \`${v}\` | test data (non-secret) |`);
+    const secrets = model.secrets.map((v) => `| \`${v}\` | **secret** — provide via environment/CI secrets only |`);
+    return ['| Variable | Purpose |', '| --- | --- |', ...common, ...data, ...secrets];
+}
+export function emitReadme(input) {
+    const isPython = input.language === 'python';
+    const { profile, model } = input;
+    const platformCoverage = [];
+    if (model.platforms.android)
+        platformCoverage.push(`Android (${profile.platforms.android.level})`);
+    if (model.platforms.ios)
+        platformCoverage.push(`iOS (${profile.platforms.ios.level})`);
+    const runCmd = isPython
+        ? profile.testFramework === 'pytest'
+            ? '```sh\npip install -r requirements.txt\nappium &   # start a local Appium server\npytest\n```'
+            : '```sh\npip install -r requirements.txt\nappium &   # start a local Appium server\npython -m unittest discover -s tests\n```'
+        : '```sh\nnpm install\nnpx appium &   # or rely on the @wdio/appium-service\nnpm test\n```';
+    const brittle = model.audit.brittle;
+    const lines = [];
+    lines.push(`# ${input.appId ?? 'App'} — Appium ${isPython ? 'Python' : 'WebdriverIO'} POM suite`);
+    lines.push('');
+    lines.push('> Generated by Swipium from recorded QA actions. **Review before committing.**');
+    lines.push('');
+    lines.push('## What this is');
+    lines.push('');
+    lines.push(`A Page/Screen Object Model Appium suite (${input.language}). Selectors live in screen objects; tests call action methods only.`);
+    lines.push('');
+    lines.push(`- **Language:** ${input.language}`);
+    lines.push(`- **Runner:** ${profile.testFramework}`);
+    lines.push(`- **Default backend:** ${profile.defaultBackend}${profile.secondaryBackend ? ` (secondary: ${profile.secondaryBackend})` : ''}`);
+    lines.push(`- **Platform coverage in this suite:** ${platformCoverage.join(', ') || 'none detected'}`);
+    lines.push(`- **Screens:** ${model.screens.map((s) => s.className).join(', ') || 'none'}`);
+    lines.push('');
+    lines.push('## Run');
+    lines.push('');
+    lines.push(runCmd);
+    lines.push('');
+    lines.push('## Environment variables');
+    lines.push('');
+    lines.push(...envTable(model, isPython));
+    lines.push('');
+    lines.push('## Locator readiness');
+    lines.push('');
+    lines.push(`Locator durability: ${model.audit.durable} durable / ${model.audit.semi} semi / ${brittle} brittle (${model.audit.brittlePct}% brittle).`);
+    if (brittle > 0) {
+        lines.push('');
+        lines.push(`⚠ ${brittle} brittle/coordinate locator(s) are marked non-release-grade in the screen objects. Add a durable accessibility id / resource-id / testID before gating CI on this suite.`);
+    }
+    lines.push('');
+    lines.push('## Honest coverage note');
+    lines.push('');
+    lines.push('iOS selectors/capabilities are emitted from app-map evidence where available, but iOS coverage is NOT proven unless the suite was actually run on iOS. XPath is never generated.');
+    lines.push('');
+    return lines.join('\n');
+}
+//# sourceMappingURL=readmeEmitter.js.map

package/dist/automationGen/readmeEmitter.js.map

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

package/dist/automationGen/suitePlan.js

@@ -0,0 +1,94 @@
+// SWIPIUM-REQ-04 — suite-generation plan. Pure: assembles the read-only plan behind
+// qa_automation_plan from the project profile + (optional) Appium model. No device, no writes.
+// Honest about prerequisites (map/recorded actions) and locator readiness.
+import { emitJsSuite } from './jsEmitter.js';
+import { emitPythonSuite } from './pythonEmitter.js';
+/** .swipium/automation/<dir> — js for TS/JS, python for Python (matches REQ-04 layout). */
+export function outputDirFor(language) {
+    return `.swipium/automation/${language === 'python' ? 'python' : 'js'}`;
+}
+function readinessFromPct(brittlePct, hasActions) {
+    if (!hasActions)
+        return 'unknown';
+    if (brittlePct === 0)
+        return 'durable';
+    if (brittlePct < 40)
+        return 'mixed';
+    return 'brittle';
+}
+export function buildSuitePlan(profile, opts = {}) {
+    const language = profile.automationLanguage;
+    const outputDir = outputDirFor(language);
+    const platforms = { android: profile.platforms.android.level !== 'none', ios: profile.platforms.ios.level !== 'none' };
+    const blockers = [];
+    const prerequisites = [];
+    const hasActions = !!opts.model && opts.model.steps.length > 0;
+    const actionCount = opts.model ? opts.model.steps.length : opts.actionCount ?? 0;
+    let mapCoverage = null;
+    let filesPlanned = [];
+    if (opts.model) {
+        const a = opts.model.audit;
+        mapCoverage = {
+            hasActions,
+            actionCount,
+            screenCount: opts.model.screens.length,
+            durable: a.durable,
+            semi: a.semi,
+            brittle: a.brittle,
+            brittlePct: a.brittlePct,
+        };
+        const files = language === 'python'
+            ? emitPythonSuite({ model: opts.model, profile, appId: opts.appId, framework: profile.testFramework === 'pytest' ? 'pytest' : 'unittest' })
+            : emitJsSuite({ model: opts.model, profile, appId: opts.appId, language });
+        filesPlanned = files.map((f) => `${outputDir}/${f.path}`);
+        filesPlanned.push(`${outputDir}/README.md`);
+        if (opts.includeCi)
+            filesPlanned.push(`${outputDir}/ci.example.yml`);
+    }
+    else {
+        // No model yet — list the skeleton we WOULD generate, and require a recording/map pass first.
+        blockers.push({
+            code: 'NO_RECORDED_ACTIONS',
+            detail: 'No recorded actions / app map to turn into a POM suite.',
+            nextStep: 'Run qa_test_this { goal: "create_automation_suite" } (smoke + explore records actions), or qa_explore to build the app map, then re-run qa_automation_generate.',
+        });
+        prerequisites.push('Record actions via qa_test_this/qa_smoke/qa_explore, or build the app map first.');
+    }
+    if (!platforms.android && !platforms.ios) {
+        blockers.push({
+            code: 'NO_PLATFORM_SUPPORT',
+            detail: 'Neither Android nor iOS support was detected for this project.',
+            nextStep: 'Pass platform=android|ios|both, or point projectRoot at the mobile app target.',
+        });
+    }
+    if (!opts.mapPresent && !opts.model) {
+        prerequisites.push('Build/refresh the app map (qa_explore) for cross-platform screen evidence.');
+    }
+    const locatorReadiness = readinessFromPct(mapCoverage?.brittlePct ?? 0, hasActions);
+    if (mapCoverage && mapCoverage.brittle > 0) {
+        blockers.push({
+            code: 'BRITTLE_LOCATORS',
+            detail: `${mapCoverage.brittle} brittle/coordinate locator(s) (${mapCoverage.brittlePct}% brittle) — not release-grade.`,
+            nextStep: 'Add durable accessibility id / resource-id / testID; generated suite marks these as candidate-only.',
+        });
+    }
+    const nextAction = blockers.some((b) => b.code === 'NO_RECORDED_ACTIONS')
+        ? 'qa_test_this { goal: "create_automation_suite" }'
+        : blockers.some((b) => b.code === 'NO_PLATFORM_SUPPORT')
+            ? 'qa_automation_plan { platform: "android" }'
+            : 'qa_automation_generate { save: true }';
+    return {
+        profile,
+        language,
+        outputDir,
+        platforms,
+        backends: { default: profile.defaultBackend, secondary: profile.secondaryBackend },
+        mapCoverage,
+        prerequisites,
+        filesPlanned,
+        blockers,
+        locatorReadiness,
+        nextAction,
+    };
+}
+//# sourceMappingURL=suitePlan.js.map

package/dist/automationGen/suitePlan.js.map

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