swipium 1.4.0 → 2.0.0

package/dist/automationGen/readmeEmitter.js

@@ -1,15 +1,16 @@
-// SWIPIUM-REQ-04 — README emitter. Pure: documents the generated suite, the required environment
+// 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) {
+import { defaultPlatformOf } from './platformResolve.js';
+function envTable(model, isPython, primary) {
     const common = [
         '| `APPIUM_HOST` / `APPIUM_PORT`' + (isPython ? ' / `APPIUM_URL`' : '') + ' | Appium server location (default 127.0.0.1:4723) |',
-        '| `SWIPIUM_PLATFORM` | `android` (default) or `ios` |',
+        `| \`SWIPIUM_PLATFORM\` | ${primary === 'ios' ? '`ios` (default) or `android`' : '`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 |`);
+    const secrets = model.secrets.map((v) => `| \`${v}\` | **secret**, provide via environment/CI secrets only |`);
     return ['| Variable | Purpose |', '| --- | --- |', ...common, ...data, ...secrets];
 }
 export function emitReadme(input) {
@@ -27,7 +28,7 @@ export function emitReadme(input) {
         : '```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(`# ${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('');
@@ -47,7 +48,7 @@ export function emitReadme(input) {
     lines.push('');
     lines.push('## Environment variables');
     lines.push('');
-    lines.push(...envTable(model, isPython));
+    lines.push(...envTable(model, isPython, defaultPlatformOf(profile, model)));
     lines.push('');
     lines.push('## Locator readiness');
     lines.push('');

package/dist/automationGen/readmeEmitter.js.map

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

package/dist/automationGen/run.js

@@ -0,0 +1,388 @@
+// "Automate my app". Generates a runnable JS/TS or Python Appium POM suite from a
+// session's recorded actions, adapting to the project's language/platform/test stack.
+//
+//   runAutomationPlan:     read-only core for qa_generate target:"appium" mode:"plan":
+//                            project profile + generation plan + blockers.
+//   runAutomationGenerate: core for qa_generate target:"appium": emit + write the JS/Python
+//                            suite (+ README, optional CI), validate.
+//
+// The canonical Swipium YAML/POM remains the intermediate model (non-goal: don't replace it). JS/Python
+// are emitted on top so they can't drift. Project-file mutation (integrateIntoProject) is consent-gated.
+// Both cores are registered through qa_generate (src/tools/generate.ts). This module registers no tool.
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { qaOk, qaError, unknownSessionError } from '../lib/result.js';
+import { unresolvedProjectRootError } from '../context/projectRoot.js';
+import { requireConsent, consumeConsent } from '../consent/consent.js';
+import { assembleAutomationSuite, buildAutomationProfile, writeAutomationFiles, mapPresent } from '../services/automationGenerate.js';
+import { buildSuitePlan } from './suitePlan.js';
+import { buildProjectProfile } from './projectProfile.js';
+import { validateGeneratedSuite } from './validation.js';
+import { structuralLiterals } from '../suite/secretGuard.js';
+import { UnemittableStepError } from './identifiers.js';
+import { getDriver } from '../session/attach.js';
+import { runExplore } from '../explore/runner.js';
+import { ensurePrelaunchAppMap } from '../appMap/prelaunch.js';
+import { loadAppMap } from '../appMap/store.js';
+import { detectFramework } from '../context/detect.js';
+import { deriveAutomationLinks, linkAutomationSuite } from '../appMap/automationLink.js';
+import { mergeFromAutomation } from '../services/testSuiteKnowledge.js';
+import { bootstrapFeatureExecution } from '../featureTesting/executionBootstrap.js';
+import { log } from '../lib/logger.js';
+/** Merge a prebuilt appMapUri into a tool result's structured content (Fix 6: a bootstrap blocker
+ *  still built the static map, so the URI must survive on the returned blocker/consent result). */
+function withAppMapUri(result, appMapUri) {
+    if (!appMapUri)
+        return result;
+    const sc = (result.structuredContent ?? {});
+    if (sc.appMapUri)
+        return result;
+    return { ...result, structuredContent: { ...sc, appMapUri } };
+}
+function resolveRoot(sessions, sessionId, projectRoot) {
+    if (sessionId) {
+        const session = sessions.get(sessionId);
+        if (session)
+            return { session, root: session.root };
+    }
+    return { root: projectRoot };
+}
+/** profileInputs from tool args. */
+function profileInputs(language, platform, integrateIntoProject) {
+    return {
+        language: (language ?? 'auto'),
+        platform: (platform ?? 'auto'),
+        integrateIntoProject: integrateIntoProject ?? false,
+    };
+}
+/**
+ * Core handler for qa_generate target:"appium" mode:"plan". Read-only: inspect the project
+ * (language, platform support, existing test stack) and build a plan for an "Automate my app"
+ * Appium POM suite: selected automation language, backends, coverage, files planned, blockers.
+ */
+/** A recorded step the generators cannot express as real code. Fail generation with the reason
+ *  instead of writing a suite that silently skips the step (§4). */
+function unemittable(e, extra = {}) {
+    return qaError({
+        what: `Automation suite not generated: ${e.message}`,
+        changedState: false,
+        retrySafe: false,
+        failureCode: e.code,
+        nextSteps: [
+            'Re-record the step with qa_act (supported: tap, type, swipe/scroll up|down|left|right, press back|home|enter, open_url), then regenerate.',
+        ],
+    }, extra);
+}
+export async function runAutomationPlan(sessions, { sessionId, projectRoot, feature, language, platform, backend, includeCi }) {
+    const { session, root } = resolveRoot(sessions, sessionId, projectRoot);
+    if (!root)
+        return unresolvedProjectRootError({ source: 'none' }, { nextSteps: ['Pass sessionId or an absolute projectRoot.'] });
+    const inputs = profileInputs(language, platform);
+    const profile = session ? buildAutomationProfile(session, inputs) : buildAutomationProfileFromRoot(root, inputs);
+    let plan;
+    if (session && session.recordedActions.length) {
+        let assembled;
+        try {
+            assembled = assembleAutomationSuite(session, { ...inputs, includeCi });
+        }
+        catch (e) {
+            if (e instanceof UnemittableStepError)
+                return unemittable(e);
+            throw e;
+        }
+        plan = assembled.plan;
+    }
+    else {
+        plan = buildSuitePlan(profile, { actionCount: session?.recordedActions.length ?? 0, mapPresent: mapPresent(root), includeCi });
+    }
+    const backendNote = backend && backend !== 'auto' && backend !== 'appium'
+        ? `\nNote: backend=${backend} requested; Appium code is generated as an ADDITIONAL layer; existing ${backend} flows are kept.`
+        : '';
+    const featureNote = feature ? ` (feature focus: ${feature})` : '';
+    const summary = `Automation plan${featureNote}: ${profile.automationLanguage} / ${profile.testFramework}, ` +
+        `default backend ${profile.defaultBackend}${profile.secondaryBackend ? ` (+${profile.secondaryBackend})` : ''}.\n` +
+        `platforms: android=${profile.platforms.android.level}, ios=${profile.platforms.ios.level}\n` +
+        (plan.mapCoverage
+            ? `coverage: ${plan.mapCoverage.actionCount} step(s), ${plan.mapCoverage.screenCount} screen(s); locators ${plan.locatorReadiness} (${plan.mapCoverage.brittlePct}% brittle)`
+            : 'coverage: no recorded actions yet') +
+        (plan.blockers.length ? `\nblockers: ${plan.blockers.map((b) => b.code).join(', ')}` : '') +
+        `\nfiles planned: ${plan.filesPlanned.length}\nnext: ${plan.nextAction}` +
+        backendNote;
+    return qaOk({ profile, plan, feature: feature ?? null, backend: backend ?? 'auto' }, summary);
+}
+/**
+ * Core handler for qa_generate target:"appium". Generates a runnable Appium POM suite from the
+ * session's recorded actions (WebdriverIO TS/JS or Python), bootstrapping a device/session/actions
+ * from projectRoot when none exist. Never inlines secrets; integrateIntoProject is consent-gated.
+ */
+export async function runAutomationGenerate(server, sessions, { sessionId, projectRoot, bootstrap, feature, device, name, language, platform, save, integrateIntoProject, includeCi, candidateOnly, brittleThreshold, consentId, approve, }) {
+    let session = sessionId ? sessions.get(sessionId) : undefined;
+    if (sessionId && !session)
+        return unknownSessionError(sessionId, ['Call qa_start_session first, or omit sessionId to bootstrap from projectRoot.']);
+    // Fix 6: one-call "Automate my app": when no session/actions exist, build the static app map
+    // (so it always exists) and bootstrap a device (consent-gated) + record actions via exploration.
+    const wantBootstrap = bootstrap !== false && (bootstrap === true || bootstrap === 'auto' || !sessionId);
+    let appMapUri;
+    const rootForMap = session?.root ?? (projectRoot && projectRoot.trim() ? projectRoot.trim() : undefined);
+    if (rootForMap && existsSync(rootForMap)) {
+        try {
+            appMapUri = ensurePrelaunchAppMap(rootForMap, { at: new Date().toISOString() }).appMapUri;
+        }
+        catch (e) {
+            log('warn', 'automation prelaunch app map failed', { err: String(e) });
+        }
+    }
+    if ((!session || !session.recordedActions.length) && wantBootstrap) {
+        let driver = session ? (await getDriver(session)).driver : undefined;
+        if (!session || !driver) {
+            if (!projectRoot?.trim() && !session) {
+                return qaError({
+                    what: 'Need a sessionId or projectRoot to bootstrap an automation suite',
+                    changedState: false,
+                    retrySafe: true,
+                    nextSteps: ['Pass projectRoot="/abs/path" (bootstrap defaults on), or a prepared sessionId.'],
+                }, appMapUri ? { appMapUri } : {});
+            }
+            const boot = await bootstrapFeatureExecution({
+                server,
+                sessions,
+                projectRoot: projectRoot?.trim() ?? session.root,
+                feature: feature ?? 'create automation suite',
+                platform: platform === 'android' || platform === 'ios' ? platform : undefined,
+                device,
+                consentId,
+                approve,
+            });
+            // Honest target blocker / consent request. But the static app map WAS still built, so the
+            // caller can read it even though no device/artifact is available (Fix 6 acceptance).
+            if (!boot.ok)
+                return withAppMapUri(boot.result, appMapUri);
+            session = boot.session;
+            driver = boot.driver;
+            if (!appMapUri && existsSync(session.root)) {
+                try {
+                    appMapUri = ensurePrelaunchAppMap(session.root, { at: new Date().toISOString() }).appMapUri;
+                }
+                catch {
+                    /* best-effort */
+                }
+            }
+        }
+        // Record durable actions via a bounded, safe exploration so generation has something to emit.
+        if (driver && !session.recordedActions.length) {
+            try {
+                await runExplore(sessions, session, driver, { goal: feature, maxScreens: 6, maxActions: 16, stopOnAuth: true });
+            }
+            catch (e) {
+                log('warn', 'automation bootstrap exploration failed', { err: String(e) });
+            }
+        }
+    }
+    if (!session)
+        return qaError({
+            what: 'Need a sessionId or projectRoot',
+            changedState: false,
+            retrySafe: true,
+            nextSteps: ['Pass a prepared sessionId, or projectRoot to bootstrap.'],
+        }, appMapUri ? { appMapUri } : {});
+    if (!session.recordedActions.length) {
+        return qaError({
+            what: 'No recorded actions to turn into an automation suite (bootstrap could not record any)',
+            changedState: false,
+            retrySafe: true,
+            failureCode: 'NO_RECORDED_ACTIONS',
+            nextSteps: [
+                'Run qa_test_this { goal: "create_automation_suite" } (smoke + explore records actions + builds the app map), then re-run qa_generate target:"appium".',
+                'Or drive the app with qa_act/qa_smoke/qa_explore first.',
+            ],
+        }, appMapUri ? { appMapUri } : {});
+    }
+    const inputs = profileInputs(language, platform, integrateIntoProject);
+    let assembled;
+    try {
+        assembled = assembleAutomationSuite(session, { ...inputs, name, includeCi });
+    }
+    catch (e) {
+        if (e instanceof UnemittableStepError)
+            return unemittable(e, appMapUri ? { appMapUri } : {});
+        throw e;
+    }
+    const validation = validateGeneratedSuite(assembled.files, {
+        brittlePct: assembled.model.audit.brittlePct,
+        brittleThreshold,
+        candidateOnly,
+        secrets: assembled.model.secrets,
+        secretValues: session.secrets,
+        structural: structuralLiterals(session.recordedActions),
+    });
+    // Defense in depth: a registered secret value in ANY generated file fails generation loudly,
+    // nothing is written (neither the suite nor the test-suite.json merge).
+    const leakFindings = validation.findings.filter((f) => f.code === 'SECRET_IN_GENERATED_OUTPUT');
+    if (leakFindings.length) {
+        return qaError({
+            what: `Automation suite not generated: a registered secret value would be written in plaintext (${leakFindings
+                .slice(0, 5)
+                .map((f) => f.file)
+                .join(', ')})`,
+            changedState: false,
+            retrySafe: false,
+            failureCode: 'SECRET_IN_GENERATED_OUTPUT',
+            nextSteps: ['Nothing was written. Re-record the credential step so it is captured as a ${VAR}, then regenerate.'],
+        }, { validation, ...(appMapUri ? { appMapUri } : {}) });
+    }
+    const doSave = save !== false;
+    let written = [];
+    let targetDir = assembled.outputDir;
+    let integrated = false;
+    let skippedExisting = [];
+    if (doSave && integrateIntoProject) {
+        // Consent-gated project mutation; never overwrite existing files.
+        const projectDir = projectTestDir(session.root, assembled.profile.automationLanguage);
+        const affects = { projectDir, files: assembled.files.map((f) => f.path) };
+        const gate = consumeConsent(consentId, approve, { action: 'automation_project_write', affects });
+        if (!gate.approved) {
+            return requireConsent({
+                action: 'automation_project_write',
+                risk: 'medium',
+                exactCommand: `write ${assembled.files.length} files into ${projectDir} (no overwrite)`,
+                affects,
+                explain: `Write the generated Appium suite into your project at ${projectDir}? Existing files are never overwritten.`,
+            });
+        }
+        const res = writeProjectFilesNoOverwrite(session.root, projectDir, assembled.files);
+        written = res.written;
+        skippedExisting = res.skipped;
+        targetDir = projectDir;
+        integrated = true;
+        sessions.recordMutation(session, {
+            tool: 'qa_generate',
+            action: 'automation_project_write',
+            risk: 'medium',
+            target: affects,
+            consent: { required: true, consentId, approved: true },
+            status: 'executed',
+        });
+    }
+    else if (doSave) {
+        written = writeAutomationFiles(session.root, assembled.outputDir, assembled.files);
+    }
+    // Fix 7: link the generated suite back into the durable app map + persistent suite, so future
+    // feature/ticket decisions know which flows are automated. Best-effort (warnings, never fatal).
+    let suiteDelta;
+    let suiteUri;
+    const automationWarnings = [];
+    if (doSave) {
+        const now = new Date().toISOString();
+        const screenNames = assembled.model.screens.map((s) => s.pageName || s.className);
+        try {
+            const fw = detectFramework(session.root);
+            const fallback = {
+                root: session.root,
+                gitRemote: null,
+                packageName: null,
+                workspaceTarget: null,
+                framework: fw,
+                platforms: fw === 'native-android' ? ['android'] : fw === 'native-ios' ? ['ios'] : ['android', 'ios'],
+            };
+            const existingMap = loadAppMap(session.root, fallback, now).map;
+            const links = existingMap ? deriveAutomationLinks(existingMap, screenNames) : { screenIds: [], featureIds: [] };
+            const suiteRef = {
+                name: name ?? `swipium-appium-${assembled.profile.automationLanguage}`,
+                path: targetDir,
+                framework: assembled.profile.automationLanguage === 'python' ? 'appium-python' : 'wdio',
+                linkedFeatureIds: links.featureIds,
+                linkedScreenIds: links.screenIds,
+            };
+            const linkRes = linkAutomationSuite(session.root, suiteRef, now);
+            if (linkRes.ok)
+                appMapUri = linkRes.appMapUri ?? appMapUri;
+            else
+                automationWarnings.push('app map not found; automation suite not linked into the map');
+        }
+        catch (e) {
+            automationWarnings.push(`app-map automation link failed: ${String(e)}`);
+        }
+        try {
+            const fw2 = detectFramework(session.root);
+            const fb2 = {
+                root: session.root,
+                gitRemote: null,
+                packageName: null,
+                workspaceTarget: null,
+                framework: fw2,
+                platforms: fw2 === 'native-android' ? ['android'] : fw2 === 'native-ios' ? ['ios'] : ['android', 'ios'],
+            };
+            const mapForLinks = loadAppMap(session.root, fb2, now).map;
+            const links = mapForLinks
+                ? deriveAutomationLinks(mapForLinks, assembled.model.screens.map((s) => s.pageName || s.className))
+                : { screenIds: [], featureIds: [] };
+            const merge = mergeFromAutomation(session.root, session, { assembled, validationOk: validation.ok, links }, { source: 'generate', now, runId: `automation-${Date.now()}`, sourceUri: appMapUri, appId: session.appId, sessionId: session.id });
+            suiteDelta = merge.delta;
+            suiteUri = merge.suiteUri;
+            if (merge.warning)
+                automationWarnings.push(merge.warning);
+        }
+        catch (e) {
+            automationWarnings.push(`suite automation merge failed: ${String(e)}`);
+        }
+    }
+    const a = assembled.model.audit;
+    const recommendation = integrated
+        ? undefined
+        : assembled.profile.outputMode === 'project_native'
+            ? 'Copy the suite into your project test dir, or re-run with integrateIntoProject:true (consent-gated).'
+            : `Generated under ${assembled.outputDir}. Install deps (${assembled.dependencyPatch.notes[0]}) and run per the README.`;
+    const summary = `✅ Generated ${assembled.profile.automationLanguage} Appium POM suite (${assembled.model.screens.length} screen(s), ${assembled.files.length} files).\n` +
+        `runner ${assembled.profile.testFramework}; backend ${assembled.profile.defaultBackend}${assembled.profile.secondaryBackend ? ` (+${assembled.profile.secondaryBackend})` : ''}\n` +
+        `locators: ${a.durable} durable / ${a.semi} semi / ${a.brittle} brittle (${a.brittlePct}% brittle)\n` +
+        `validation: ${validation.ok ? 'passed' : 'FAILED'} (${validation.findings.filter((f) => f.severity === 'error').length} error, ${validation.findings.filter((f) => f.severity === 'warning').length} warn); secrets ${validation.secretsClean ? 'clean' : 'LEAK'}\n` +
+        (written.length ? `wrote ${written.length} files under ${join(session.root, targetDir)}` : '(preview, pass save:true)') +
+        (skippedExisting.length
+            ? `\nskipped ${skippedExisting.length} existing file(s) (no overwrite): ${skippedExisting.slice(0, 5).join(', ')}`
+            : '') +
+        (recommendation ? `\n${recommendation}` : '');
+    return qaOk({
+        profile: assembled.profile,
+        outputDir: targetDir,
+        integrated,
+        files: assembled.files.map((f) => f.path),
+        written,
+        skippedExisting,
+        screens: assembled.model.screens.map((s) => s.className),
+        variables: assembled.model.variables,
+        secrets: assembled.model.secrets,
+        audit: a,
+        validation,
+        dependencyPatch: assembled.dependencyPatch,
+        plan: assembled.plan,
+        appMapUri: appMapUri ?? null,
+        suiteDelta: suiteDelta ?? null,
+        suiteUri: suiteUri ?? null,
+        automationWarnings,
+    }, summary);
+}
+// ---- helpers that need root-only (no session) profile ----
+function buildAutomationProfileFromRoot(root, inputs) {
+    return buildProjectProfile(root, inputs);
+}
+function projectTestDir(root, language) {
+    const candidates = language === 'python' ? ['tests/e2e', 'e2e', 'tests'] : ['e2e', 'test/e2e', 'tests/e2e'];
+    const found = candidates.find((c) => existsSync(join(root, c)));
+    return found ?? (language === 'python' ? 'tests/e2e' : 'e2e');
+}
+function writeProjectFilesNoOverwrite(root, dir, files) {
+    const written = [];
+    const skipped = [];
+    for (const f of files) {
+        const abs = join(root, dir, f.path);
+        if (existsSync(abs)) {
+            skipped.push(f.path);
+            continue;
+        }
+        mkdirSync(dirname(abs), { recursive: true });
+        writeFileSync(abs, f.content);
+        written.push(abs);
+    }
+    return { written, skipped };
+}
+//# sourceMappingURL=run.js.map

package/dist/automationGen/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/automationGen/run.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,sFAAsF;AACtF,EAAE;AACF,uFAAuF;AACvF,2EAA2E;AAC3E,4FAA4F;AAC5F,sEAAsE;AACtE,EAAE;AACF,wGAAwG;AACxG,yGAAyG;AACzG,wGAAwG;AAExG,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvE,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AACtI,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACzF,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAC;AACpF,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAQvC;mGACmG;AACnG,SAAS,aAAa,CAAC,MAAsB,EAAE,SAAkB;IAC/D,IAAI,CAAC,SAAS;QAAE,OAAO,MAAM,CAAC;IAC9B,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,iBAAiB,IAAI,EAAE,CAA4B,CAAC;IACvE,IAAI,EAAE,CAAC,SAAS;QAAE,OAAO,MAAM,CAAC;IAChC,OAAO,EAAE,GAAG,MAAM,EAAE,iBAAiB,EAAE,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,EAAE,CAAC;AAChE,CAAC;AAED,SAAS,WAAW,CAAC,QAAsB,EAAE,SAAkB,EAAE,WAAoB;IACnF,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACxC,IAAI,OAAO;YAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;IACtD,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;AAC/B,CAAC;AAED,oCAAoC;AACpC,SAAS,aAAa,CAAC,QAA6B,EAAE,QAA6B,EAAE,oBAA8B;IACjH,OAAO;QACL,QAAQ,EAAE,CAAC,QAAQ,IAAI,MAAM,CAAoD;QACjF,QAAQ,EAAE,CAAC,QAAQ,IAAI,MAAM,CAAwC;QACrE,oBAAoB,EAAE,oBAAoB,IAAI,KAAK;KACpD,CAAC;AACJ,CAAC;AAYD;;;;GAIG;AACH;oEACoE;AACpE,SAAS,WAAW,CAAC,CAAuB,EAAE,QAAiC,EAAE;IAC/E,OAAO,OAAO,CACZ;QACE,IAAI,EAAE,mCAAmC,CAAC,CAAC,OAAO,EAAE;QACpD,YAAY,EAAE,KAAK;QACnB,SAAS,EAAE,KAAK;QAChB,WAAW,EAAE,CAAC,CAAC,IAAI;QACnB,SAAS,EAAE;YACT,2IAA2I;SAC5I;KACF,EACD,KAAK,CACN,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,QAAsB,EACtB,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAsB;IAE/F,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,WAAW,CAAC,QAAQ,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;IACxE,IAAI,CAAC,IAAI;QAAE,OAAO,0BAA0B,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,4CAA4C,CAAC,EAAE,CAAC,CAAC;IAEhI,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,sBAAsB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,8BAA8B,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAEjH,IAAI,IAAI,CAAC;IACT,IAAI,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC;QAC9C,IAAI,SAAS,CAAC;QACd,IAAI,CAAC;YACH,SAAS,GAAG,uBAAuB,CAAC,OAAO,EAAE,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QACzE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,oBAAoB;gBAAE,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC;YAC7D,MAAM,CAAC,CAAC;QACV,CAAC;QACD,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC;IACxB,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,cAAc,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,CAAC,MAAM,IAAI,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;IACjI,CAAC;IAED,MAAM,WAAW,GACf,OAAO,IAAI,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,QAAQ;QACnD,CAAC,CAAC,mBAAmB,OAAO,yEAAyE,OAAO,kBAAkB;QAC9H,CAAC,CAAC,EAAE,CAAC;IACT,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,oBAAoB,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAClE,MAAM,OAAO,GACX,kBAAkB,WAAW,KAAK,OAAO,CAAC,kBAAkB,MAAM,OAAO,CAAC,aAAa,IAAI;QAC3F,mBAAmB,OAAO,CAAC,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK;QAClH,sBAAsB,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,SAAS,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,IAAI;QAC7F,CAAC,IAAI,CAAC,WAAW;YACf,CAAC,CAAC,aAAa,IAAI,CAAC,WAAW,CAAC,WAAW,aAAa,IAAI,CAAC,WAAW,CAAC,WAAW,wBAAwB,IAAI,CAAC,gBAAgB,KAAK,IAAI,CAAC,WAAW,CAAC,UAAU,YAAY;YAC7K,CAAC,CAAC,mCAAmC,CAAC;QACxC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1F,oBAAoB,IAAI,CAAC,YAAY,CAAC,MAAM,WAAW,IAAI,CAAC,UAAU,EAAE;QACxE,WAAW,CAAC;IACd,OAAO,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;AAChG,CAAC;AAoBD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAiB,EACjB,QAAsB,EACtB,EACE,SAAS,EACT,WAAW,EACX,SAAS,EACT,OAAO,EACP,MAAM,EACN,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,IAAI,EACJ,oBAAoB,EACpB,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,OAAO,GACgB;IAEzB,IAAI,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9D,IAAI,SAAS,IAAI,CAAC,OAAO;QACvB,OAAO,mBAAmB,CAAC,SAAS,EAAE,CAAC,+EAA+E,CAAC,CAAC,CAAC;IAE3H,6FAA6F;IAC7F,iGAAiG;IACjG,MAAM,aAAa,GAAG,SAAS,KAAK,KAAK,IAAI,CAAC,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC;IACxG,IAAI,SAA6B,CAAC;IAClC,MAAM,UAAU,GAAG,OAAO,EAAE,IAAI,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACzG,IAAI,UAAU,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACzC,IAAI,CAAC;YACH,SAAS,GAAG,qBAAqB,CAAC,UAAU,EAAE,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC;QAC5F,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,GAAG,CAAC,MAAM,EAAE,qCAAqC,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAED,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,aAAa,EAAE,CAAC;QACnE,IAAI,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;QACrE,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;YACxB,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;gBACrC,OAAO,OAAO,CACZ;oBACE,IAAI,EAAE,kEAAkE;oBACxE,YAAY,EAAE,KAAK;oBACnB,SAAS,EAAE,IAAI;oBACf,SAAS,EAAE,CAAC,gFAAgF,CAAC;iBAC9F,EACD,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAC/B,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,yBAAyB,CAAC;gBAC3C,MAAM;gBACN,QAAQ;gBACR,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,OAAQ,CAAC,IAAI;gBACjD,OAAO,EAAE,OAAO,IAAI,yBAAyB;gBAC7C,QAAQ,EAAE,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;gBAC7E,MAAM;gBACN,SAAS;gBACT,OAAO;aACR,CAAC,CAAC;YACH,0FAA0F;YAC1F,qFAAqF;YACrF,IAAI,CAAC,IAAI,CAAC,EAAE;gBAAE,OAAO,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YAC3D,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;YACvB,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;YACrB,IAAI,CAAC,SAAS,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC3C,IAAI,CAAC;oBACH,SAAS,GAAG,qBAAqB,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC;gBAC9F,CAAC;gBAAC,MAAM,CAAC;oBACP,iBAAiB;gBACnB,CAAC;YACH,CAAC;QACH,CAAC;QACD,8FAA8F;QAC9F,IAAI,MAAM,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC;YAC9C,IAAI,CAAC;gBACH,MAAM,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;YAClH,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,GAAG,CAAC,MAAM,EAAE,yCAAyC,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC7E,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAO;QACV,OAAO,OAAO,CACZ;YACE,IAAI,EAAE,iCAAiC;YACvC,YAAY,EAAE,KAAK;YACnB,SAAS,EAAE,IAAI;YACf,SAAS,EAAE,CAAC,yDAAyD,CAAC;SACvE,EACD,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAC/B,CAAC;IACJ,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC;QACpC,OAAO,OAAO,CACZ;YACE,IAAI,EAAE,uFAAuF;YAC7F,YAAY,EAAE,KAAK;YACnB,SAAS,EAAE,IAAI;YACf,WAAW,EAAE,qBAAqB;YAClC,SAAS,EAAE;gBACT,uJAAuJ;gBACvJ,yDAAyD;aAC1D;SACF,EACD,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAC/B,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,oBAAoB,CAAC,CAAC;IACvE,IAAI,SAAS,CAAC;IACd,IAAI,CAAC;QACH,SAAS,GAAG,uBAAuB,CAAC,OAAO,EAAE,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IAC/E,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,oBAAoB;YAAE,OAAO,WAAW,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC7F,MAAM,CAAC,CAAC;IACV,CAAC;IACD,MAAM,UAAU,GAAG,sBAAsB,CAAC,SAAS,CAAC,KAAK,EAAE;QACzD,UAAU,EAAE,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU;QAC5C,gBAAgB;QAChB,aAAa;QACb,OAAO,EAAE,SAAS,CAAC,KAAK,CAAC,OAAO;QAChC,YAAY,EAAE,OAAO,CAAC,OAAO;QAC7B,UAAU,EAAE,kBAAkB,CAAC,OAAO,CAAC,eAAe,CAAC;KACxD,CAAC,CAAC;IACH,6FAA6F;IAC7F,wEAAwE;IACxE,MAAM,YAAY,GAAG,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,4BAA4B,CAAC,CAAC;IAChG,IAAI,YAAY,CAAC,MAAM,EAAE,CAAC;QACxB,OAAO,OAAO,CACZ;YACE,IAAI,EAAE,4FAA4F,YAAY;iBAC3G,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;iBACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;iBAClB,IAAI,CAAC,IAAI,CAAC,GAAG;YAChB,YAAY,EAAE,KAAK;YACnB,SAAS,EAAE,KAAK;YAChB,WAAW,EAAE,4BAA4B;YACzC,SAAS,EAAE,CAAC,oGAAoG,CAAC;SAClH,EACD,EAAE,UAAU,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CACpD,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,KAAK,KAAK,CAAC;IAC9B,IAAI,OAAO,GAAa,EAAE,CAAC;IAC3B,IAAI,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC;IACpC,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,IAAI,eAAe,GAAa,EAAE,CAAC;IAEnC,IAAI,MAAM,IAAI,oBAAoB,EAAE,CAAC;QACnC,kEAAkE;QAClE,MAAM,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QACtF,MAAM,OAAO,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1E,MAAM,IAAI,GAAG,cAAc,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,0BAA0B,EAAE,OAAO,EAAE,CAAC,CAAC;QACjG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,OAAO,cAAc,CAAC;gBACpB,MAAM,EAAE,0BAA0B;gBAClC,IAAI,EAAE,QAAQ;gBACd,YAAY,EAAE,SAAS,SAAS,CAAC,KAAK,CAAC,MAAM,eAAe,UAAU,iBAAiB;gBACvF,OAAO;gBACP,OAAO,EAAE,yDAAyD,UAAU,yCAAyC;aACtH,CAAC,CAAC;QACL,CAAC;QACD,MAAM,GAAG,GAAG,4BAA4B,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;QACpF,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;QACtB,eAAe,GAAG,GAAG,CAAC,OAAO,CAAC;QAC9B,SAAS,GAAG,UAAU,CAAC;QACvB,UAAU,GAAG,IAAI,CAAC;QAClB,QAAQ,CAAC,cAAc,CAAC,OAAO,EAAE;YAC/B,IAAI,EAAE,aAAa;YACnB,MAAM,EAAE,0BAA0B;YAClC,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,OAAO;YACf,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE;YACtD,MAAM,EAAE,UAAU;SACnB,CAAC,CAAC;IACL,CAAC;SAAM,IAAI,MAAM,EAAE,CAAC;QAClB,OAAO,GAAG,oBAAoB,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IACrF,CAAC;IAED,8FAA8F;IAC9F,gGAAgG;IAChG,IAAI,UAAuE,CAAC;IAC5E,IAAI,QAA4B,CAAC;IACjC,MAAM,kBAAkB,GAAa,EAAE,CAAC;IACxC,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,WAAW,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC;QAClF,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,QAAQ,GAAoB;gBAChC,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,SAAS,EAAE,IAAI;gBACf,WAAW,EAAE,IAAI;gBACjB,eAAe,EAAE,IAAI;gBACrB,SAAS,EAAE,EAAE;gBACb,SAAS,EAAE,EAAE,KAAK,gBAAgB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,YAAY,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC;aACtG,CAAC;YACF,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC;YAChE,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,qBAAqB,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;YAChH,MAAM,QAAQ,GAAG;gBACf,IAAI,EAAE,IAAI,IAAI,kBAAkB,SAAS,CAAC,OAAO,CAAC,kBAAkB,EAAE;gBACtE,IAAI,EAAE,SAAS;gBACf,SAAS,EAAE,SAAS,CAAC,OAAO,CAAC,kBAAkB,KAAK,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,MAAM;gBACvF,gBAAgB,EAAE,KAAK,CAAC,UAAU;gBAClC,eAAe,EAAE,KAAK,CAAC,SAAS;aACjC,CAAC;YACF,MAAM,OAAO,GAAG,mBAAmB,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;YACjE,IAAI,OAAO,CAAC,EAAE;gBAAE,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,SAAS,CAAC;;gBACtD,kBAAkB,CAAC,IAAI,CAAC,6DAA6D,CAAC,CAAC;QAC9F,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,kBAAkB,CAAC,IAAI,CAAC,mCAAmC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC1C,MAAM,GAAG,GAAoB;gBAC3B,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,SAAS,EAAE,IAAI;gBACf,WAAW,EAAE,IAAI;gBACjB,eAAe,EAAE,IAAI;gBACrB,SAAS,EAAE,GAAG;gBACd,SAAS,EAAE,GAAG,KAAK,gBAAgB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,YAAY,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC;aACxG,CAAC;YACF,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC;YAC3D,MAAM,KAAK,GAAG,WAAW;gBACvB,CAAC,CAAC,qBAAqB,CACnB,WAAW,EACX,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,SAAS,CAAC,CAC9D;gBACH,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;YACtC,MAAM,KAAK,GAAG,mBAAmB,CAC/B,OAAO,CAAC,IAAI,EACZ,OAAO,EACP,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,EAAE,KAAK,EAAE,EACjD,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,KAAK,EAAE,cAAc,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,CAClI,CAAC;YACF,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC;YACzB,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;YAC1B,IAAI,KAAK,CAAC,OAAO;gBAAE,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC5D,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,kBAAkB,CAAC,IAAI,CAAC,kCAAkC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAED,MAAM,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC;IAChC,MAAM,cAAc,GAAG,UAAU;QAC/B,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,KAAK,gBAAgB;YACjD,CAAC,CAAC,sGAAsG;YACxG,CAAC,CAAC,mBAAmB,SAAS,CAAC,SAAS,mBAAmB,SAAS,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,2BAA2B,CAAC;IAC7H,MAAM,OAAO,GACX,eAAe,SAAS,CAAC,OAAO,CAAC,kBAAkB,sBAAsB,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,eAAe,SAAS,CAAC,KAAK,CAAC,MAAM,YAAY;QACxJ,UAAU,SAAS,CAAC,OAAO,CAAC,aAAa,aAAa,SAAS,CAAC,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,MAAM,SAAS,CAAC,OAAO,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI;QAClL,aAAa,CAAC,CAAC,OAAO,cAAc,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,OAAO,aAAa,CAAC,CAAC,UAAU,cAAc;QACrG,eAAe,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,MAAM,WAAW,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,MAAM,mBAAmB,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,IAAI;QACrQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,gBAAgB,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,2BAA2B,CAAC;QACvH,CAAC,eAAe,CAAC,MAAM;YACrB,CAAC,CAAC,aAAa,eAAe,CAAC,MAAM,qCAAqC,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YAClH,CAAC,CAAC,EAAE,CAAC;QACP,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAChD,OAAO,IAAI,CACT;QACE,OAAO,EAAE,SAAS,CAAC,OAAO;QAC1B,SAAS,EAAE,SAAS;QACpB,UAAU;QACV,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACzC,OAAO;QACP,eAAe;QACf,OAAO,EAAE,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACxD,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC,SAAS;QACpC,OAAO,EAAE,SAAS,CAAC,KAAK,CAAC,OAAO;QAChC,KAAK,EAAE,CAAC;QACR,UAAU;QACV,eAAe,EAAE,SAAS,CAAC,eAAe;QAC1C,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,SAAS,EAAE,SAAS,IAAI,IAAI;QAC5B,UAAU,EAAE,UAAU,IAAI,IAAI;QAC9B,QAAQ,EAAE,QAAQ,IAAI,IAAI;QAC1B,kBAAkB;KACnB,EACD,OAAO,CACR,CAAC;AACJ,CAAC;AAED,6DAA6D;AAC7D,SAAS,8BAA8B,CAAC,IAAY,EAAE,MAAwC;IAC5F,OAAO,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,cAAc,CAAC,IAAY,EAAE,QAAgD;IACpF,MAAM,UAAU,GAAG,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IAC5G,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAChE,OAAO,KAAK,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,4BAA4B,CAAC,IAAY,EAAE,GAAW,EAAE,KAAsB;IACrF,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACrB,SAAS;QACX,CAAC;QACD,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,aAAa,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;QAC9B,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC"}

package/dist/automationGen/suitePlan.js

@@ -1,9 +1,9 @@
-// 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.
+// Suite-generation plan. Pure: assembles the read-only plan behind
+// the qa_generate target:"appium" 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). */
+/** .swipium/automation/<dir>: js for TS/JS, python for Python (the generated-suite layout). */
 export function outputDirFor(language) {
     return `.swipium/automation/${language === 'python' ? 'python' : 'js'}`;
 }
@@ -23,7 +23,7 @@ export function buildSuitePlan(profile, opts = {}) {
     const blockers = [];
     const prerequisites = [];
     const hasActions = !!opts.model && opts.model.steps.length > 0;
-    const actionCount = opts.model ? opts.model.steps.length : opts.actionCount ?? 0;
+    const actionCount = opts.model ? opts.model.steps.length : (opts.actionCount ?? 0);
     let mapCoverage = null;
     let filesPlanned = [];
     if (opts.model) {
@@ -38,7 +38,12 @@ export function buildSuitePlan(profile, opts = {}) {
             brittlePct: a.brittlePct,
         };
         const files = language === 'python'
-            ? emitPythonSuite({ model: opts.model, profile, appId: opts.appId, framework: profile.testFramework === 'pytest' ? 'pytest' : 'unittest' })
+            ? 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`);
@@ -46,11 +51,11 @@ export function buildSuitePlan(profile, opts = {}) {
             filesPlanned.push(`${outputDir}/ci.example.yml`);
     }
     else {
-        // No model yet — list the skeleton we WOULD generate, and require a recording/map pass first.
+        // 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.',
+            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_generate target:"appium".',
         });
         prerequisites.push('Record actions via qa_test_this/qa_smoke/qa_explore, or build the app map first.');
     }
@@ -68,20 +73,22 @@ export function buildSuitePlan(profile, opts = {}) {
     if (mapCoverage && mapCoverage.brittle > 0) {
         blockers.push({
             code: 'BRITTLE_LOCATORS',
-            detail: `${mapCoverage.brittle} brittle/coordinate locator(s) (${mapCoverage.brittlePct}% brittle) — not release-grade.`,
+            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 }';
+            ? 'qa_generate { target: "appium", mode: "plan", platform: "android" }'
+            : 'qa_generate { target: "appium", save: true }';
     return {
         profile,
         language,
         outputDir,
         platforms,
+        primaryPlatform: profile.primaryPlatform ?? (profile.defaultBackend === 'appium-xcuitest' ? 'ios' : 'android'),
+        platformSource: profile.platformSource ?? 'project',
         backends: { default: profile.defaultBackend, secondary: profile.secondaryBackend },
         mapCoverage,
         prerequisites,

package/dist/automationGen/suitePlan.js.map

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