swipium 1.0.0

package/dist/suite/compile.js

@@ -0,0 +1,176 @@
+// POM → Flow V2 compiler (hardening P0.4). Generated POM suites reference page-object elements by
+// name; this resolves those refs against the page objects and emits Flow V2 YAML that parseFlow()
+// accepts and qa_flow_run / `swipium ci` can execute. Without this, a generated suite is only
+// documentation — with it, a recorded run becomes a runnable, CI-usable flow.
+//
+// PURE: reads YAML files, no device. The compiler output is validated by the caller via parseFlow().
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { parse as parseYaml, stringify } from 'yaml';
+import { waitForVisibleGuard } from '../flows/waitGuards.js';
+/** Load all page objects under .swipium/pages, keyed by their declared `name`. */
+export function loadPages(root) {
+    const dir = join(root, '.swipium', 'pages');
+    const out = new Map();
+    if (!existsSync(dir))
+        return out;
+    for (const f of readdirSync(dir)) {
+        if (!f.endsWith('.page.yaml'))
+            continue;
+        try {
+            const doc = parseYaml(readFileSync(join(dir, f), 'utf8'));
+            if (doc?.name)
+                out.set(doc.name, doc);
+        }
+        catch {
+            /* skip unparseable page */
+        }
+    }
+    return out;
+}
+/** Turn a page element's locator into a Flow V2 selector string (mirrors flow generate). */
+export function elementSelector(el) {
+    if (!el)
+        return null;
+    if (typeof el['accessibility id'] === 'string')
+        return `accessibility id=${el['accessibility id']}`;
+    // Android resource id → `id=<value>`: the Flow V2 runner resolves this via resolveTarget({ id }).
+    // (A bare `resource-id=` prefix is NOT parsed by the runner and would fall back to a text match.)
+    if (typeof el['resource-id'] === 'string')
+        return `id=${el['resource-id']}`;
+    if (typeof el.name === 'string')
+        return `name=${el.name}`;
+    if (typeof el.predicate === 'string')
+        return `predicate string=${el.predicate}`;
+    if (typeof el['class chain'] === 'string')
+        return `class chain=${el['class chain']}`;
+    if (typeof el.text === 'string')
+        return el.text; // bare text selector
+    if (typeof el.fallbackText === 'string')
+        return el.fallbackText;
+    return null;
+}
+/** Compile one POM test doc into a Flow V2 flow object + variables + per-step errors. */
+export function compileTest(testDoc, pages) {
+    const errors = [];
+    const variables = new Set();
+    const steps = ['prepareTarget'];
+    const resolveSel = (s) => {
+        if (!s.element)
+            return null;
+        const page = s.page ? pages.get(s.page) : undefined;
+        if (!page) {
+            errors.push(`step references unknown page "${s.page}"`);
+            return null;
+        }
+        const el = page.elements?.[s.element];
+        const sel = elementSelector(el);
+        if (!sel)
+            errors.push(`page "${s.page}" has no usable locator for element "${s.element}"`);
+        return sel;
+    };
+    const rawSteps = testDoc.steps ?? [];
+    rawSteps.forEach((s, i) => {
+        const collectVars = (t) => {
+            if (t)
+                for (const m of t.matchAll(/\$\{([^}]+)\}/g))
+                    variables.add(m[1]);
+        };
+        switch (s.action) {
+            case 'tap':
+                if (s.element) {
+                    const sel = resolveSel(s);
+                    if (sel)
+                        steps.push(waitForVisibleGuard(sel), { tap: sel });
+                }
+                else if (s.coords) {
+                    steps.push({ tapAt: s.coords });
+                }
+                else {
+                    errors.push(`step ${i}: tap has neither element nor coords`);
+                }
+                break;
+            case 'tapAt':
+                if (s.coords)
+                    steps.push({ tapAt: s.coords });
+                break;
+            case 'inputText': {
+                collectVars(s.text);
+                const sel = s.element ? resolveSel(s) : null;
+                if (s.element && sel)
+                    steps.push(waitForVisibleGuard(sel), { inputText: { into: sel, text: s.text ?? '', ...(s.secret ? { secret: true } : {}) } });
+                else
+                    steps.push({ inputText: s.text ?? '' });
+                break;
+            }
+            case 'press':
+                steps.push({ press: s.key ?? 'back' });
+                break;
+            case 'swipe':
+                steps.push({ swipe: s.direction ?? 'up' });
+                break;
+            case 'scrollTo': {
+                const sel = resolveSel(s);
+                if (sel)
+                    steps.push({ scrollTo: sel });
+                break;
+            }
+            case 'openUrl':
+                if (s.url)
+                    steps.push({ openUrl: s.url });
+                break;
+            case 'assertVisible':
+                if (s.text)
+                    steps.push(waitForVisibleGuard(s.text), { assertVisible: s.text });
+                break;
+            default:
+                errors.push(`step ${i}: unknown action "${s.action}"`);
+        }
+    });
+    const flow = { name: testDoc.name ?? 'compiled' };
+    if (testDoc.appId)
+        flow.appId = testDoc.appId;
+    if (testDoc.budgetProfile)
+        flow.budgetProfile = testDoc.budgetProfile;
+    flow.steps = steps;
+    return { flow, variables: [...variables], errors };
+}
+/** Load a POM test file (tests/*.smoke.yaml) and compile it to Flow V2 YAML. */
+export function compileTestFile(root, testRel, pages) {
+    const abs = join(root, '.swipium', testRel.replace(/^\.swipium\//, ''));
+    if (!existsSync(abs))
+        return { name: testRel, yaml: '', variables: [], errors: [`test file not found: ${testRel}`] };
+    let doc;
+    try {
+        doc = parseYaml(readFileSync(abs, 'utf8'));
+    }
+    catch (e) {
+        return { name: testRel, yaml: '', variables: [], errors: [`could not parse ${testRel}: ${String(e.message ?? e)}`] };
+    }
+    const compiled = compileTest(doc, pages ?? loadPages(root));
+    const header = [
+        '# Compiled by Swipium qa_suite_compile from a POM test — runnable via qa_flow_run / `swipium ci`.',
+        ...(compiled.variables.length ? [`# variables: ${compiled.variables.join(', ')}`] : []),
+    ].join('\n');
+    return { name: doc.name ?? testRel, yaml: `${header}\n${stringify(compiled.flow)}`, variables: compiled.variables, errors: compiled.errors };
+}
+/** Compile every test referenced by a suite file (default .swipium/suites/smoke.yaml). */
+export function compileSuite(root, suiteRel = 'suites/smoke.yaml') {
+    const abs = join(root, '.swipium', suiteRel.replace(/^\.swipium\//, ''));
+    if (!existsSync(abs))
+        return { suite: suiteRel, flows: [], errors: [`suite not found: ${suiteRel}`] };
+    let doc;
+    try {
+        doc = parseYaml(readFileSync(abs, 'utf8'));
+    }
+    catch (e) {
+        return { suite: suiteRel, flows: [], errors: [`could not parse suite: ${String(e.message ?? e)}`] };
+    }
+    const tests = doc.tests ?? [];
+    if (!tests.length)
+        return { suite: suiteRel, flows: [], errors: ['suite has no tests'] };
+    const pages = loadPages(root);
+    const flows = tests.map((t) => compileTestFile(root, t, pages));
+    return { suite: suiteRel, flows, errors: [] };
+}
+//# sourceMappingURL=compile.js.map

package/dist/suite/compile.js.map

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

package/dist/suite/lint.js

@@ -0,0 +1,45 @@
+// Suite linting (roadmap §6 / §12 `swipium suite lint`) — flag page objects whose locators are
+// brittle (coordinate-only), copy/locale-fragile (text), or dynamic-looking. Reads the generated
+// .swipium/pages/*.page.yaml; shared by the suite CLI.
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+export function lintSuitePages(root) {
+    const pagesDir = join(root, '.swipium', 'pages');
+    if (!existsSync(pagesDir))
+        return { pagesDir, exists: false, pageCount: 0, items: [] };
+    const items = [];
+    let pageCount = 0;
+    for (const f of readdirSync(pagesDir)) {
+        if (!f.endsWith('.page.yaml'))
+            continue;
+        pageCount++;
+        let doc;
+        try {
+            doc = parseYaml(readFileSync(join(pagesDir, f), 'utf8'));
+        }
+        catch {
+            items.push({ page: f, element: '(file)', severity: 'error', message: 'could not parse page YAML' });
+            continue;
+        }
+        const pageName = doc?.name ?? f;
+        const elements = doc?.elements ?? {};
+        for (const [name, el] of Object.entries(elements)) {
+            const durability = el.durability;
+            const hasLocator = el['accessibility id'] || el['resource-id'] || el.text || el.name;
+            const readinessCode = typeof el.readinessCode === 'string' ? el.readinessCode : undefined;
+            if (durability === 'brittle' || !hasLocator) {
+                items.push({ page: pageName, element: name, severity: 'error', code: readinessCode ?? 'COORDINATE_ONLY', message: el.remediation ?? 'no durable locator (coordinate-only) — add a testID/accessibilityIdentifier' });
+            }
+            else if (durability === 'semi' || el.text) {
+                const code = readinessCode ?? ((el.text || el.name) && !el['accessibility id'] ? 'IOS_MISSING_ACCESSIBILITY_IDENTIFIER' : undefined);
+                items.push({ page: pageName, element: name, severity: 'warning', code, message: el.remediation ?? 'text/locale-fragile selector — add an accessibilityIdentifier/testID for CI-stable replay' });
+            }
+            if (typeof el.text === 'string' && /\d{3,}|[0-9a-f]{8,}/i.test(el.text)) {
+                items.push({ page: pageName, element: name, severity: 'warning', code: 'DYNAMIC_TEXT_LOCATOR', message: `selector "${el.text}" looks dynamic (contains digits/ids) — prefer a stable identifier` });
+            }
+        }
+    }
+    return { pagesDir, exists: true, pageCount, items };
+}
+//# sourceMappingURL=lint.js.map

package/dist/suite/lint.js.map

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

package/dist/suite/pom.js

@@ -0,0 +1,285 @@
+// Screen/Page Object Model generation (roadmap §6) — turn a linear action recording into a
+// MAINTAINABLE suite where selectors live in page objects and tests reference them by name,
+// instead of duplicating raw selectors. PURE: no filesystem, no device — callers serialize the
+// returned files. Also produces a locator audit (durable vs brittle) with app-code remediation,
+// because durable automation is the point (§2.4 / §6 locator policy).
+import { stringify } from 'yaml';
+function durabilityOf(kind) {
+    switch (kind) {
+        case 'accessibility_id':
+        case 'resource_id':
+            return 'durable';
+        case 'name':
+        case 'predicate':
+        case 'class_chain':
+        case 'text':
+            return 'semi';
+        default:
+            return 'brittle'; // coords / unknown
+    }
+}
+function pascal(s) {
+    const parts = s
+        .replace(/[^A-Za-z0-9]+/g, ' ')
+        .trim()
+        .split(/\s+/)
+        .filter(Boolean);
+    return parts.map((p) => p[0].toUpperCase() + p.slice(1)).join('') || 'Screen';
+}
+function camel(s) {
+    const p = pascal(s);
+    return p ? p[0].toLowerCase() + p.slice(1) : 'el';
+}
+/** Page name from a foreground-owner string: strip android package, take a readable segment. */
+function pageNameFromScreen(screen, index) {
+    if (!screen)
+        return `Screen${index + 1}Page`;
+    // android: com.app/.LoginActivity → LoginActivity → LoginPage
+    const activity = screen.includes('/') ? screen.split('/').pop() : screen.split('.').pop();
+    const base = activity.replace(/Activity$|ViewController$|Screen$/i, '');
+    return `${pascal(base || activity)}Page`;
+}
+/** Derive a meaningful secret variable name (P0.5) — reuses an existing ${VAR} the agent set,
+ *  else names from the field (password/otp/token), else a numbered SWIPIUM_SECRET_N. */
+function secretVarFor(a, index) {
+    const existing = a.text?.match(/^\$\{([^}]+)\}$/);
+    // Reuse an already-meaningful var; but rename a generic recorder placeholder (SECRET_N).
+    if (existing && !/^SECRET_\d+$/i.test(existing[1]))
+        return existing[1];
+    const key = `${a.selector ?? ''}`.toLowerCase();
+    if (/pass/.test(key))
+        return 'SWIPIUM_TEST_PASSWORD';
+    if (/otp|code|2fa|mfa/.test(key))
+        return 'SWIPIUM_TEST_OTP';
+    if (/token|api[_-]?key/.test(key))
+        return 'SWIPIUM_TEST_TOKEN';
+    if (/pin/.test(key))
+        return 'SWIPIUM_TEST_PIN';
+    return `SWIPIUM_SECRET_${index}`;
+}
+function remediationFor(el) {
+    if (el.selectorKind === 'coords') {
+        return `add a testID (RN) / accessibilityIdentifier (iOS) / android:contentDescription / Flutter Key + Semantics(identifier:) to the tapped element${el.screen ? ` on ${el.screen}` : ''} — it has no durable locator`;
+    }
+    if (el.selectorKind === 'text') {
+        return `text selector "${el.selector}" is locale/copy-fragile — add an accessibilityIdentifier/testID (or a Flutter Key/Semantics label) for CI-stable replay`;
+    }
+    if (el.selectorKind === 'name') {
+        return `iOS name selector "${el.selector}" can drift with labels/localization — add an accessibilityIdentifier for CI-stable replay`;
+    }
+    if (el.selectorKind === 'predicate' || el.selectorKind === 'class_chain') {
+        return `iOS ${el.selectorKind} selector "${el.selector}" is a fallback locator — prefer accessibilityIdentifier and avoid XPath-style hierarchy dependence`;
+    }
+    return undefined;
+}
+function auditCodeFor(el) {
+    if (el.selectorKind === 'coords')
+        return 'COORDINATE_ONLY';
+    if (el.selectorKind === 'text' || el.selectorKind === 'name' || el.selectorKind === 'predicate' || el.selectorKind === 'class_chain')
+        return 'IOS_MISSING_ACCESSIBILITY_IDENTIFIER';
+    return undefined;
+}
+/**
+ * Build the POM model + serialized files from a recording.
+ *  - segments the recording into pages by screen (foreground owner);
+ *  - hoists each distinct selector into a named page element (de-duped);
+ *  - emits a test that references `page` + `element` (no raw selectors in the test);
+ *  - turns secrets into ${VARS};
+ *  - audits every locator's durability with app-code remediation.
+ */
+export function generatePom(actions, opts) {
+    // 1. segment into pages by contiguous screen.
+    const pages = [];
+    const usedPageNames = new Set();
+    const pageByScreen = new Map();
+    const pageFor = (screen) => {
+        const key = screen ?? '__unknown__';
+        const existing = pageByScreen.get(key);
+        if (existing)
+            return existing;
+        let name = pageNameFromScreen(screen, pages.length);
+        let n = 2;
+        const baseName = name;
+        while (usedPageNames.has(name))
+            name = `${baseName.replace(/Page$/, '')}${n++}Page`;
+        usedPageNames.add(name);
+        const page = { name, screen, elements: [] };
+        pages.push(page);
+        pageByScreen.set(key, page);
+        return page;
+    };
+    const steps = [];
+    const variables = [];
+    let secretCount = 0;
+    const ensureElement = (page, a) => {
+        // Coordinate-only actions have no nameable element — keep as inline coords in the step.
+        if (!a.selector || a.selectorKind === 'coords')
+            return undefined;
+        const baseName = camel(a.selector);
+        let name = baseName || 'el';
+        // Reuse if an element with the same selector already exists on this page.
+        const match = page.elements.find((e) => e.selector === a.selector && e.selectorKind === a.selectorKind);
+        if (match)
+            return match.name;
+        let n = 2;
+        while (page.elements.some((e) => e.name === name))
+            name = `${baseName}${n++}`;
+        const durability = durabilityOf(a.selectorKind);
+        const readinessCode = auditCodeFor({ selectorKind: a.selectorKind ?? 'text' });
+        const el = {
+            name,
+            selector: a.selector,
+            selectorKind: a.selectorKind ?? 'text',
+            fallbackText: a.selectorKind === 'text' ? a.selector : undefined,
+            required: true,
+            secure: a.secret || undefined,
+            durability,
+            readinessCode,
+            remediation: remediationFor({ selectorKind: a.selectorKind ?? 'text', selector: a.selector, screen: a.screen }),
+        };
+        page.elements.push(el);
+        return name;
+    };
+    for (const a of actions) {
+        const page = pageFor(a.screen);
+        switch (a.action) {
+            case 'tap':
+            case 'clear': {
+                const element = ensureElement(page, a);
+                if (element)
+                    steps.push({ page: page.name, element, action: a.action === 'clear' ? 'inputText' : 'tap', ...(a.action === 'clear' ? { text: '' } : {}) });
+                else
+                    steps.push({ page: page.name, action: 'tap', coords: [a.x ?? 0, a.y ?? 0] });
+                break;
+            }
+            case 'type': {
+                const element = ensureElement(page, a);
+                let text = a.text ?? '';
+                if (a.secret) {
+                    // Secret values become ${SWIPIUM_TEST_*} variables — never the raw value (P0.5).
+                    const v = secretVarFor(a, ++secretCount);
+                    text = `\${${v}}`;
+                    variables.push(v);
+                }
+                else {
+                    // A non-secret value the agent already templated (e.g. ${SWIPIUM_TEST_EMAIL}) is preserved.
+                    for (const m of text.matchAll(/\$\{([^}]+)\}/g))
+                        variables.push(m[1]);
+                }
+                steps.push({ page: page.name, element, action: 'inputText', text, secret: a.secret || undefined });
+                break;
+            }
+            case 'press':
+                steps.push({ page: page.name, action: 'press', key: a.key ?? 'back' });
+                break;
+            case 'swipe':
+                steps.push({ page: page.name, action: 'swipe', direction: a.direction ?? 'up' });
+                break;
+            case 'scroll': {
+                const element = ensureElement(page, a);
+                if (element)
+                    steps.push({ page: page.name, element, action: 'scrollTo' });
+                else
+                    steps.push({ page: page.name, action: 'swipe', direction: a.direction ?? 'up' });
+                break;
+            }
+            case 'open_url':
+                steps.push({ page: page.name, action: 'openUrl', url: a.url ?? '' });
+                break;
+            case 'assert_visual':
+                steps.push({ page: page.name, action: 'assertVisible', text: a.assertion ?? a.selector });
+                break;
+        }
+    }
+    // 2. audit.
+    const entries = [];
+    for (const p of pages) {
+        for (const e of p.elements) {
+            entries.push({ page: p.name, element: e.name, durability: e.durability, selectorKind: e.selectorKind, code: e.readinessCode, remediation: e.remediation });
+        }
+    }
+    // coordinate-only steps also count against durability.
+    for (const s of steps) {
+        if (!s.element && s.coords)
+            entries.push({ page: s.page, element: `(coords ${s.coords[0]},${s.coords[1]})`, durability: 'brittle', selectorKind: 'coords', code: 'COORDINATE_ONLY', remediation: remediationFor({ selectorKind: 'coords' }) });
+    }
+    const durable = entries.filter((e) => e.durability === 'durable').length;
+    const semi = entries.filter((e) => e.durability === 'semi').length;
+    const brittle = entries.filter((e) => e.durability === 'brittle').length;
+    const total = entries.length || 1;
+    const audit = { entries, durable, semi, brittle, brittlePct: Math.round((brittle / total) * 100) };
+    // 3. serialize files.
+    const files = [];
+    for (const p of pages) {
+        const elementsYaml = {};
+        for (const e of p.elements) {
+            const ev = {};
+            if (e.selectorKind === 'accessibility_id')
+                ev['accessibility id'] = e.selector;
+            else if (e.selectorKind === 'resource_id')
+                ev['resource-id'] = e.selector;
+            else if (e.selectorKind === 'text')
+                ev.text = e.selector;
+            else
+                ev[e.selectorKind] = e.selector;
+            if (e.fallbackText && e.selectorKind !== 'text')
+                ev.fallbackText = e.fallbackText;
+            if (e.required)
+                ev.required = true;
+            if (e.secure)
+                ev.secure = true;
+            ev.durability = e.durability;
+            if (e.readinessCode)
+                ev.readinessCode = e.readinessCode;
+            if (e.remediation)
+                ev.remediation = e.remediation;
+            elementsYaml[e.name] = ev;
+        }
+        const pageObj = { name: p.name, platforms: ['android', 'ios'], screen: p.screen ?? undefined, elements: elementsYaml };
+        files.push({ path: `pages/${kebab(p.name)}.page.yaml`, content: `# Swipium page object — review before committing.\n${stringify(pageObj)}` });
+    }
+    const testObj = { name: opts.name };
+    if (opts.appId)
+        testObj.appId = opts.appId;
+    if (opts.budgetProfile)
+        testObj.budgetProfile = opts.budgetProfile;
+    testObj.uses = pages.map((p) => `pages/${kebab(p.name)}.page.yaml`);
+    testObj.steps = steps.map(serializeStep);
+    const testHeader = [
+        '# Swipium test (POM) — selectors live in page objects; this test references them by name.',
+        ...(variables.length ? [`# variables — provide via qa_flow_run { variables }: ${variables.join(', ')}`] : []),
+        `# locator durability: ${durable} durable / ${semi} semi / ${brittle} brittle (${audit.brittlePct}% brittle)`,
+    ].join('\n');
+    files.push({ path: `tests/${kebab(opts.name)}.smoke.yaml`, content: `${testHeader}\n${stringify(testObj)}` });
+    const suiteObj = { name: 'smoke', tests: [`tests/${kebab(opts.name)}.smoke.yaml`] };
+    files.push({ path: 'suites/smoke.yaml', content: `# Swipium suite.\n${stringify(suiteObj)}` });
+    files.push({ path: 'locators/locator-audit.json', content: JSON.stringify(audit, null, 2) });
+    return { pages, testName: opts.name, steps, variables: [...new Set(variables)], audit, files };
+}
+function serializeStep(s) {
+    const ref = s.element ? { page: s.page, element: s.element } : { page: s.page };
+    switch (s.action) {
+        case 'tap':
+            return s.element ? { ...ref, action: 'tap' } : { ...ref, action: 'tapAt', coords: s.coords };
+        case 'inputText':
+            return { ...ref, action: 'inputText', text: s.text ?? '', ...(s.secret ? { secret: true } : {}) };
+        case 'press':
+            return { ...ref, action: 'press', key: s.key };
+        case 'swipe':
+            return { ...ref, action: 'swipe', direction: s.direction };
+        case 'scrollTo':
+            return { ...ref, action: 'scrollTo' };
+        case 'openUrl':
+            return { ...ref, action: 'openUrl', url: s.url };
+        case 'assertVisible':
+            return { ...ref, action: 'assertVisible', text: s.text };
+    }
+}
+function kebab(s) {
+    return s
+        .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+        .replace(/[^A-Za-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .toLowerCase();
+}
+//# sourceMappingURL=pom.js.map

package/dist/suite/pom.js.map

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

package/dist/suite/testcase.js

@@ -0,0 +1,87 @@
+// Test-case documentation (roadmap §7) — turn a generated POM suite + the session's observed
+// state into an industry-style test case catalog (TC-xxx) with preconditions, steps, expected
+// result, automation status, known blockers, and last-run evidence. PURE; callers serialize.
+import { stringify } from 'yaml';
+function humanStep(s) {
+    switch (s.action) {
+        case 'tap':
+            return s.element ? `Tap ${s.element} on ${s.page}` : `Tap at (${s.coords?.[0]},${s.coords?.[1]}) on ${s.page}`;
+        case 'inputText':
+            return `Enter ${s.secret ? 'secret value' : `"${s.text}"`} into ${s.element ?? 'the focused field'} on ${s.page}`;
+        case 'press':
+            return `Press ${s.key}`;
+        case 'swipe':
+            return `Swipe ${s.direction} on ${s.page}`;
+        case 'scrollTo':
+            return `Scroll to ${s.element} on ${s.page}`;
+        case 'openUrl':
+            return `Open ${s.url}`;
+        case 'assertVisible':
+            return `Verify "${s.text}" is visible on ${s.page}`;
+    }
+}
+export function generateTestCases(pom, opts) {
+    const platform = opts.platform ?? 'android+ios';
+    const fixtures = opts.fixtures ?? [];
+    const notes = opts.notes ?? [];
+    const replayStatus = opts.replayStatus ?? 'not_replayed';
+    // Automation status from the locator audit: any brittle locator → partial, else automated.
+    const status = pom.audit.brittle > 0 ? 'partial' : 'automated';
+    const knownBlockers = notes
+        .filter((n) => n.outcome === 'blocked' || n.category === 'missing_test_data')
+        .map((n) => `${n.workflow}: ${n.reason ?? n.missingPrecondition ?? 'blocked'}${n.recommendedSetup ? ` — ${n.recommendedSetup}` : ''}`);
+    const evidence = notes.flatMap((n) => n.artifactUris ?? []);
+    const verifiedVisualOnly = notes.some((n) => n.method === 'visual' || n.verifiedVisually);
+    const expected = pom.steps
+        .filter((s) => s.action === 'assertVisible' && s.text)
+        .map((s) => `${s.text} is visible`);
+    if (expected.length === 0)
+        expected.push('App reaches the expected post-flow screen without an error surface');
+    // Actual result = what THIS run observed (Deliverable 4). Kept separate from `expected` so a
+    // reviewer/QA can compare intent vs. outcome. When the flow was only recorded (not executed as a
+    // discrete test), say so honestly rather than implying a pass.
+    const actualResult = notes.length
+        ? notes.map((n) => `${n.workflow}: ${n.outcome}${n.reason ? ` — ${n.reason}` : ''}`)
+        : ['Not executed as a discrete test in this run — generated from recorded actions; replay to capture an actual result.'];
+    const tc = {
+        id: `TC-${(opts.appId ?? 'APP').split('.').pop().slice(0, 6).toUpperCase()}-001`,
+        title: pom.testName.replace(/[-_]/g, ' '),
+        purpose: `Verify the "${pom.testName}" flow end-to-end.`,
+        priority: 'P0',
+        platform,
+        preconditions: ['app installed', ...(opts.appId ? [`app id ${opts.appId}`] : []), ...fixtures.map((f) => f.requiredState ?? f.name)],
+        fixtures: fixtures.map((f) => f.name),
+        steps: pom.steps.map(humanStep),
+        expected,
+        actualResult,
+        cleanup: ['return to home/initial screen', ...(verifiedVisualOnly ? [] : [])],
+        risks: [
+            ...(pom.audit.brittle > 0 ? [`${pom.audit.brittle} brittle locator(s) — flow may break on UI changes (see locator audit)`] : []),
+            ...(verifiedVisualOnly ? ['some verification was visual-only — weaker than a structured assertion'] : []),
+            ...(pom.variables.length ? [`requires test data: ${pom.variables.join(', ')}`] : []),
+        ],
+        automation: { status, test: `tests/${kebab(pom.testName)}.smoke.yaml`, pageObjects: pom.pages.map((p) => `pages/${kebab(p.name)}.page.yaml`) },
+        replayStatus,
+        knownBlockers,
+        evidence,
+    };
+    const cases = [tc];
+    const yaml = `# Swipium test case catalog.\n${stringify({ cases })}`;
+    const markdown = renderMarkdown(cases);
+    return { cases, yaml, markdown };
+}
+function renderMarkdown(cases) {
+    const out = ['# Test Cases', ''];
+    for (const c of cases) {
+        out.push(`## ${c.id}: ${c.title}`, ``, `- **Priority:** ${c.priority}  **Platform:** ${c.platform}  **Automation:** ${c.automation.status}`, `- **Purpose:** ${c.purpose}`, ``, `**Preconditions:**`, ...c.preconditions.map((p) => `- ${p}`), ``, `**Steps:**`, ...c.steps.map((s, i) => `${i + 1}. ${s}`), ``, `**Expected:**`, ...c.expected.map((e) => `- ${e}`), ``, `**Actual result:**`, ...c.actualResult.map((e) => `- ${e}`), ``, `- **Replay status:** ${c.replayStatus}`, ...(c.evidence.length ? [`- **Evidence:** ${c.evidence.join(', ')}`] : []), ...(c.cleanup.length ? [`- **Cleanup:** ${c.cleanup.join('; ')}`] : []), ...(c.risks.length ? [``, `**Risks:**`, ...c.risks.map((r) => `- ${r}`)] : []), ...(c.knownBlockers.length ? [``, `**Known blockers:**`, ...c.knownBlockers.map((b) => `- ${b}`)] : []), ...(c.automation.pageObjects.length ? [``, `**Page objects:** ${c.automation.pageObjects.join(', ')}`] : []), ``);
+    }
+    return out.join('\n');
+}
+function kebab(s) {
+    return s
+        .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+        .replace(/[^A-Za-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .toLowerCase();
+}
+//# sourceMappingURL=testcase.js.map