swipium 1.0.0

package/dist/flows/generate.js

@@ -0,0 +1,211 @@
+// qa_flow_generate core (PHASE3-PLAN §4.1 / DESIGN §8). Two pure pieces:
+//   - recordableTap: at qa_act time, turn a resolved tap target into a replayable descriptor +
+//     exportability tag (translating an @ref into its visible text/label where possible — the
+//     key durability insight: a ref is run-time-only, but its label survives).
+//   - generateFlow: serialize the recorded action IR into a durable flow YAML + a durability
+//     grade and the brittle steps that need a testID/accessibilityLabel.
+import { createHash } from 'node:crypto';
+import { stringify } from 'yaml';
+import { waitForVisibleGuard } from './waitGuards.js';
+function currentScreenSignature(session) {
+    const sigs = session.lastSnapshot?.signatures;
+    if (!sigs?.size)
+        return undefined;
+    return createHash('sha1').update([...sigs].sort().join('\n')).digest('hex').slice(0, 16);
+}
+function bucketBounds(bounds, point) {
+    const b = bounds ?? (point ? [point.x, point.y, point.x, point.y] : undefined);
+    if (!b)
+        return undefined;
+    const bucket = (n) => Math.floor(n / 50) * 50;
+    return `${bucket(b[0])},${bucket(b[1])},${bucket(b[2])},${bucket(b[3])}`;
+}
+function provenance(session, opts) {
+    const node = opts.point?.ref ? session.lastSnapshot?.fullByRef.get(opts.point.ref) : undefined;
+    const out = {
+        originalScreenSignature: currentScreenSignature(session),
+        elementRole: node?.cls?.split('.').pop(),
+        className: node?.cls,
+        text: node?.text || undefined,
+        accessibilityLabel: node?.desc || undefined,
+        resourceId: node?.id || undefined,
+        boundsBucket: bucketBounds(node?.bounds, opts.point),
+        screenshotUri: session.artifacts?.filter((a) => a.kind === 'screenshot').at(-1)?.uri,
+        selectorKind: opts.selectorKind,
+        selectorValue: opts.selectorValue,
+    };
+    return Object.values(out).some((v) => v != null) ? out : undefined;
+}
+/** Map a resolved tap to a replayable descriptor. Prefers a visible text/label (durable);
+ *  falls back to coordinates (brittle) when the element exposes no human-readable handle. */
+export function recordableTap(session, target, point) {
+    if (target?.x != null)
+        return { x: point.x, y: point.y, selectorKind: 'coords', exportability: 'coordinate', provenance: provenance(session, { selectorKind: 'coords', point }) };
+    if (target?.id) {
+        const selectorKind = session.driver?.kind === 'wda' ? 'accessibility_id' : 'resource_id';
+        return { selector: target.id, selectorKind, exportability: 'semantic', provenance: provenance(session, { selectorKind, selectorValue: target.id, point }) };
+    }
+    const node = point.ref ? session.lastSnapshot?.fullByRef.get(point.ref) : target?.ref ? session.lastSnapshot?.fullByRef.get(target.ref) : undefined;
+    if (session.driver?.kind === 'wda' && node?.id)
+        return { selector: node.id, selectorKind: 'accessibility_id', exportability: 'semantic', provenance: provenance(session, { selectorKind: 'accessibility_id', selectorValue: node.id, point }) };
+    let label;
+    if (target?.text)
+        label = target.text;
+    else
+        label = node?.text || node?.desc || undefined;
+    if (label) {
+        const warning = session.driver?.kind === 'wda'
+            ? `iOS label/name selector "${label}" is usable, but add an accessibilityIdentifier for CI-stable replay`
+            : undefined;
+        return { selector: label, selectorKind: 'text', exportability: 'semantic', warning, provenance: provenance(session, { selectorKind: 'text', selectorValue: label, point }) };
+    }
+    return { x: point.x, y: point.y, selectorKind: 'coords', exportability: 'coordinate', provenance: provenance(session, { selectorKind: 'coords', point }) };
+}
+export function recordableNativeSelector(session, selectorKind, selectorValue) {
+    return { provenance: provenance(session, { selectorKind, selectorValue }) };
+}
+function actionSelector(a) {
+    if (!a.selector || !['text', 'accessibility_id', 'resource_id', 'name', 'predicate', 'class_chain'].includes(a.selectorKind ?? ''))
+        return null;
+    return a.selectorKind === 'accessibility_id'
+        ? `accessibility id=${a.selector}`
+        : a.selectorKind === 'resource_id'
+            ? `id=${a.selector}` // Flow V2 runner resolves `id=<resource-id>` via resolveTarget({ id })
+            : a.selectorKind === 'name'
+                ? `name=${a.selector}`
+                : a.selectorKind === 'predicate'
+                    ? `predicate string=${a.selector}`
+                    : a.selectorKind === 'class_chain'
+                        ? `class chain=${a.selector}`
+                        : a.selector;
+}
+function addProvenance(entries, a, actionIndex, generatedStepIndex, generatedKind, selector) {
+    if (!a.provenance)
+        return;
+    entries.push({ actionIndex, generatedStepIndex, generatedKind, action: a.action, selector: selector ?? a.selector, ...a.provenance });
+}
+function pushSelectorAction(steps, provenanceEntries, a, actionIndex, selector, action, generatedKind) {
+    const waitIndex = steps.length + 1;
+    const actionStepIndex = steps.length + 2;
+    steps.push(waitForVisibleGuard(selector), action);
+    addProvenance(provenanceEntries, a, actionIndex, waitIndex, 'waitForVisible', selector);
+    addProvenance(provenanceEntries, a, actionIndex, actionStepIndex, generatedKind, selector);
+}
+export function generateFlow(actions, opts) {
+    const steps = ['prepareTarget'];
+    const brittleSteps = [];
+    const variables = [];
+    const provenanceEntries = [];
+    let semantic = 0;
+    let coordinate = 0;
+    let needsHumanData = 0;
+    let secretCount = 0;
+    actions.forEach((a, i) => {
+        const actionIndex = i + 1;
+        switch (a.action) {
+            case 'tap':
+                {
+                    const selector = actionSelector(a);
+                    if (selector) {
+                        pushSelectorAction(steps, provenanceEntries, a, actionIndex, selector, { tap: selector }, 'tap');
+                        semantic++;
+                        if (a.warning)
+                            brittleSteps.push({ index: i, reason: a.warning });
+                    }
+                    else {
+                        addProvenance(provenanceEntries, a, actionIndex, steps.length + 1, 'tapAt');
+                        steps.push({ tapAt: [a.x ?? 0, a.y ?? 0] });
+                        coordinate++;
+                        brittleSteps.push({ index: i, reason: `tapped by coordinates (${a.x},${a.y})${a.screen ? ` on ${a.screen}` : ''} — add a testID/accessibilityLabel for a durable selector` });
+                    }
+                }
+                break;
+            case 'clear': {
+                const selector = actionSelector(a);
+                if (selector) {
+                    pushSelectorAction(steps, provenanceEntries, a, actionIndex, selector, { inputText: { into: selector, text: '' } }, 'inputText');
+                    semantic++;
+                }
+                else {
+                    addProvenance(provenanceEntries, a, actionIndex, steps.length + 1, 'tapAt');
+                    steps.push({ tapAt: [a.x ?? 0, a.y ?? 0] }, { inputText: '' });
+                    coordinate++;
+                    brittleSteps.push({ index: i, reason: `cleared by coordinates (${a.x},${a.y})${a.screen ? ` on ${a.screen}` : ''} — add a testID/accessibilityLabel for a durable selector` });
+                }
+                break;
+            }
+            case 'type':
+                {
+                    const selector = actionSelector(a);
+                    const text = a.secret ? `\${SECRET_${++secretCount}}` : a.text ?? '';
+                    if (a.secret) {
+                        variables.push(`SECRET_${secretCount}`);
+                        needsHumanData++;
+                    }
+                    else {
+                        semantic++;
+                    }
+                    if (selector)
+                        pushSelectorAction(steps, provenanceEntries, a, actionIndex, selector, { inputText: { into: selector, text } }, 'inputText');
+                    else {
+                        addProvenance(provenanceEntries, a, actionIndex, steps.length + 1, 'inputText');
+                        steps.push({ inputText: text });
+                    }
+                }
+                break;
+            case 'swipe':
+                steps.push({ swipe: a.direction ?? 'up' });
+                coordinate++;
+                break;
+            case 'scroll':
+                if (a.selector) {
+                    addProvenance(provenanceEntries, a, actionIndex, steps.length + 1, 'scrollTo', a.selector);
+                    steps.push({ scrollTo: a.selector });
+                    semantic++;
+                }
+                else {
+                    steps.push({ swipe: a.direction ?? 'up' });
+                    coordinate++;
+                }
+                break;
+            case 'press':
+                steps.push({ press: a.key ?? 'back' });
+                semantic++;
+                break;
+            case 'open_url':
+                steps.push({ openUrl: a.url ?? '' });
+                semantic++;
+                break;
+            case 'assert_visual':
+                addProvenance(provenanceEntries, a, actionIndex, steps.length + 1, 'assertVisual', a.assertion ?? a.selector ?? 'visual checkpoint');
+                steps.push({ assertVisual: a.assertion ?? a.selector ?? 'visual checkpoint' });
+                semantic++;
+                break;
+        }
+    });
+    const total = semantic + coordinate + needsHumanData;
+    const semanticPct = total ? Math.round((semantic / total) * 100) : 100;
+    const grade = semanticPct >= 90 ? 'A' : semanticPct >= 70 ? 'B' : 'C';
+    const flowObj = { name: opts.name };
+    if (opts.appId)
+        flowObj.appId = opts.appId;
+    if (opts.budgetProfile)
+        flowObj.budgetProfile = opts.budgetProfile;
+    if (provenanceEntries.length)
+        flowObj.provenance = provenanceEntries;
+    flowObj.steps = steps;
+    const header = [
+        `# Generated by Swipium qa_flow_generate — review before committing.`,
+        `# durability: ${grade} (${semanticPct}% semantic; ${coordinate} coordinate, ${needsHumanData} needs-human-data)`,
+        ...(variables.length ? [`# variables — provide via qa_flow_run { variables }: ${variables.join(', ')}`] : []),
+        ...brittleSteps.map((b) => `# WARNING step ${b.index}: ${b.reason}`),
+    ].join('\n');
+    return {
+        yaml: `${header}\n${stringify(flowObj)}`,
+        stepCount: steps.length,
+        durability: { grade, semanticPct, semantic, coordinate, needsHumanData },
+        brittleSteps,
+        variables,
+    };
+}
+//# sourceMappingURL=generate.js.map

package/dist/flows/generate.js.map

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

package/dist/flows/lint.js

@@ -0,0 +1,97 @@
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { parseFlow } from './schema.js';
+import { ciMutationAllowed, loadPolicy } from '../report/policy.js';
+const MUTATING = new Set(['networkOffline', 'networkOnline', 'seed', 'restartApp']);
+const SECRET_LITERAL = /password|passwd|secret|token|otp|api[_-]?key/i;
+function stepText(step) {
+    switch (step.kind) {
+        case 'tap': return step.selector;
+        case 'inputText': return step.value;
+        case 'assertVisible':
+        case 'assertNotVisible':
+        case 'waitForVisible':
+        case 'wait':
+        case 'scrollTo':
+            return 'query' in step && typeof step.query === 'string' ? step.query : '';
+        default:
+            return '';
+    }
+}
+function mutatingPolicyMessage(step, policy) {
+    if (!MUTATING.has(step.kind))
+        return null;
+    if (policy === undefined)
+        return null;
+    if (ciMutationAllowed(policy, step.kind))
+        return null;
+    return policy
+        ? `${step.kind} changes device/app/test state but is not allowed by .swipium/policy.json ciAllowMutations.`
+        : `${step.kind} changes device/app/test state but no .swipium/policy.json ciAllowMutations policy was found.`;
+}
+export function lintFlowObject(file, flow, policy) {
+    return lintFlowObjectWithOptions(file, flow, { policy });
+}
+export function lintFlowObjectWithOptions(file, flow, opts = {}) {
+    const findings = [];
+    const all = [...flow.setup, ...flow.steps, ...flow.teardown];
+    const setupHasMutation = flow.setup.some((step) => MUTATING.has(step.kind));
+    if (setupHasMutation && !flow.teardown.length) {
+        findings.push({ file, flow: flow.name, severity: 'warn', code: 'MUTATING_SETUP_WITHOUT_TEARDOWN', message: 'Setup mutates device/app/test state but the flow has no teardown; add cleanup/restore steps or document why state reuse is safe.' });
+    }
+    for (let i = 0; i < all.length; i++) {
+        const step = all[i];
+        const stepNo = i + 1;
+        const text = stepText(step);
+        if (step.kind === 'tapAt') {
+            findings.push({ file, flow: flow.name, step: stepNo, severity: 'warn', code: 'COORDINATE_ONLY', message: 'Coordinate-only tap is brittle; prefer an accessibility id or stable text locator.' });
+        }
+        if (/xpath=|^\/\//i.test(text)) {
+            findings.push({ file, flow: flow.name, step: stepNo, severity: 'warn', code: 'XPATH_LOCATOR', message: 'XPath locators are brittle and slow; prefer accessibility id/name, predicate/class-chain on iOS, or resource id on Android.' });
+        }
+        if ((opts.platform === 'cross-platform' || (!opts.platform && flow.mode === 'auto')) && /(resource-id=|uiautomator|android\.|accessibility id=|name=|class chain|predicate string|XCUIElementType)/i.test(text)) {
+            findings.push({ file, flow: flow.name, step: stepNo, severity: 'warn', code: 'PLATFORM_SPECIFIC_LOCATOR', message: 'Platform-specific locator in an auto/cross-platform flow; prefer shared text/testID/accessibility labels or split into platform-specific flows.' });
+        }
+        if (opts.platform === 'ios' && /resource-id=|uiautomator|android\./i.test(text)) {
+            findings.push({ file, flow: flow.name, step: stepNo, severity: 'warn', code: 'ANDROID_LOCATOR_IN_IOS_FLOW', message: 'Android-specific locator in an iOS flow; prefer accessibilityIdentifier/name/label, predicate string, or class chain.' });
+        }
+        if (opts.platform === 'android' && /class chain|predicate string|XCUIElementType|accessibility id=|name=/i.test(text)) {
+            findings.push({ file, flow: flow.name, step: stepNo, severity: 'warn', code: 'IOS_LOCATOR_IN_ANDROID_FLOW', message: 'iOS-specific locator in an Android flow; prefer resource-id, content-desc, or stable text.' });
+        }
+        if (step.kind === 'inputText' && !/\$\{[^}]+}/.test(step.value) && (step.secret || SECRET_LITERAL.test(step.value))) {
+            findings.push({ file, flow: flow.name, step: stepNo, severity: 'error', code: 'INLINE_SECRET', message: 'Secret-looking input is inline; use ${ENV_VAR} from CI secrets instead.' });
+        }
+        if ((step.kind === 'assertVisible' || step.kind === 'assertNotVisible') && i > 0) {
+            const prev = all[i - 1];
+            if (!['wait', 'waitForVisible', 'waitForIdle', 'assertVisible', 'assertNotVisible'].includes(prev.kind)) {
+                findings.push({ file, flow: flow.name, step: stepNo, severity: 'warn', code: 'ASSERT_WITHOUT_WAIT', message: 'Assertion follows an action without an explicit wait; add waitForVisible/waitForIdle for CI stability.' });
+            }
+        }
+        if (MUTATING.has(step.kind)) {
+            findings.push({ file, flow: flow.name, step: stepNo, severity: 'warn', code: 'MUTATING_STEP', message: 'Mutating step requires explicit CI policy allowance and should have teardown where applicable.' });
+            const policyMessage = mutatingPolicyMessage(step, opts.policy);
+            if (policyMessage) {
+                findings.push({ file, flow: flow.name, step: stepNo, severity: 'error', code: 'MUTATING_STEP_WITHOUT_POLICY', message: policyMessage });
+            }
+        }
+    }
+    return findings;
+}
+export function lintFlowFiles(root, opts = {}) {
+    const dir = join(root, '.swipium', 'flows');
+    if (!existsSync(dir))
+        return { files: 0, findings: [{ file: dir, severity: 'error', code: 'NO_FLOWS_DIR', message: 'No .swipium/flows directory found.' }] };
+    const policy = loadPolicy(root);
+    const files = readdirSync(dir).filter((f) => /\.ya?ml$/i.test(f)).map((f) => join(dir, f));
+    const findings = [];
+    for (const file of files) {
+        const { flow, errors } = parseFlow(readFileSync(file, 'utf8'));
+        if (errors.length || !flow) {
+            findings.push({ file, severity: 'error', code: 'INVALID_FLOW', message: errors.join('; ') || 'Invalid flow.' });
+            continue;
+        }
+        findings.push(...lintFlowObjectWithOptions(file, flow, { ...opts, policy }));
+    }
+    return { files: files.length, findings };
+}
+//# sourceMappingURL=lint.js.map

package/dist/flows/lint.js.map

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

package/dist/flows/pack.js

@@ -0,0 +1,68 @@
+// Flow packs (NEXT-PLAN: Flow System V2). A pack (.swipium/packs/*.yaml) names an ordered set of
+// flows to run as one release suite. v1 runs them sequentially on the one attached device
+// (parallel:true is accepted but ignored with a warning — parallel on a single device is unsafe).
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join, basename } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { parseFlow } from './schema.js';
+import { runFlow } from './run.js';
+export function parsePack(yamlText) {
+    let doc;
+    try {
+        doc = parseYaml(yamlText);
+    }
+    catch (e) {
+        return { errors: [`YAML parse error: ${String(e.message ?? e)}`] };
+    }
+    if (!doc || typeof doc !== 'object')
+        return { errors: ['pack must be a YAML map with name + flows.'] };
+    const d = doc;
+    const errors = [];
+    if (typeof d.name !== 'string' || !d.name.trim())
+        errors.push('pack needs a non-empty `name`.');
+    if (!Array.isArray(d.flows) || d.flows.length === 0 || !d.flows.every((f) => typeof f === 'string'))
+        errors.push('pack needs a non-empty `flows` list of flow names.');
+    if (errors.length)
+        return { errors };
+    return { pack: { name: d.name, flows: d.flows, parallel: d.parallel === true }, errors: [] };
+}
+export function listPackFiles(root) {
+    const dir = join(root, '.swipium', 'packs');
+    if (!existsSync(dir))
+        return [];
+    try {
+        return readdirSync(dir)
+            .filter((f) => /\.ya?ml$/i.test(f))
+            .map((f) => ({ name: basename(f).replace(/\.ya?ml$/i, ''), path: join(dir, f) }));
+    }
+    catch {
+        return [];
+    }
+}
+function flowPath(root, name) {
+    for (const p of [join(root, '.swipium', 'flows', `${name}.yaml`), join(root, '.swipium', 'flows', `${name}.yml`)])
+        if (existsSync(p))
+            return p;
+    return null;
+}
+export async function runPack(sessions, session, driver, root, pack, opts = {}) {
+    const warnings = [];
+    if (pack.parallel)
+        warnings.push('parallel:true ignored — flows run sequentially on a single device (parallel needs a device matrix).');
+    const results = [];
+    for (const name of pack.flows) {
+        const p = flowPath(root, name);
+        if (!p) {
+            results.push({ name, passed: false, reason: `flow not found: ${name}`, failureCode: 'NO_ARTIFACT', steps: [], durationSec: 0, counters: session.counters });
+            continue;
+        }
+        const { flow, errors } = parseFlow(readFileSync(p, 'utf8'));
+        if (errors.length || !flow) {
+            results.push({ name, passed: false, reason: `invalid flow: ${errors[0] ?? 'parse error'}`, failureCode: 'UNKNOWN', steps: [], durationSec: 0, counters: session.counters });
+            continue;
+        }
+        results.push(await runFlow(sessions, session, driver, flow, opts));
+    }
+    return { pack: pack.name, parallelRequested: pack.parallel, results, passed: results.every((r) => r.passed), warnings };
+}
+//# sourceMappingURL=pack.js.map

package/dist/flows/pack.js.map

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