swipium 1.0.0

package/dist/automationGen/validation.js

@@ -0,0 +1,150 @@
+// SWIPIUM-REQ-04 — generated-code validation. Pure: validates emitted files WITHOUT a device.
+// Checks (REQ-04 §qa_automation_validate + acceptance criteria):
+//   - no inlined secrets (env-only),
+//   - locator durability threshold (fails on brittle-only above threshold unless candidate-only),
+//   - capability config presence,
+//   - lightweight syntax sanity (brace balance for JS/TS),
+//   - no empty essential files.
+// password = "literal" / token: 'literal' etc. — but NOT process.env / os.environ references.
+const SECRET_ASSIGN_RE = /(password|passwd|secret|token|api[_-]?key|apikey|bearer|credential|pwd)\s*[:=]\s*(["'])(?!\s*\2)([^"']{3,})\2/i;
+const ENV_REF_RE = /(process\.env|os\.environ|getenv|\$\{?env)/i;
+function scanSecrets(files, secrets) {
+    const findings = [];
+    for (const f of files) {
+        const lines = f.content.split('\n');
+        lines.forEach((line, i) => {
+            // Skip comment lines and lines that read from the environment.
+            const trimmed = line.trim();
+            if (trimmed.startsWith('//') || trimmed.startsWith('#') || trimmed.startsWith('*'))
+                return;
+            if (ENV_REF_RE.test(line))
+                return;
+            const m = SECRET_ASSIGN_RE.exec(line);
+            if (m) {
+                findings.push({ code: 'INLINED_SECRET', severity: 'error', file: f.path, message: `possible inlined secret at line ${i + 1}: ${m[1]} assigned a literal — read from the environment instead` });
+            }
+            // Explicit: a known secret env-var name assigned a literal value.
+            for (const s of secrets) {
+                const re = new RegExp(`${s}\\s*[:=]\\s*["'][^"']+["']`);
+                if (re.test(line) && !ENV_REF_RE.test(line)) {
+                    findings.push({ code: 'INLINED_SECRET', severity: 'error', file: f.path, message: `secret var ${s} assigned a literal at line ${i + 1}` });
+                }
+            }
+        });
+    }
+    return findings;
+}
+function braceBalance(files) {
+    const findings = [];
+    for (const f of files) {
+        if (!/\.(ts|js)$/.test(f.path))
+            continue;
+        const pairs = [['{', '}', 'braces'], ['(', ')', 'parens'], ['[', ']', 'brackets']];
+        // Strip strings/comments crudely to avoid counting literals.
+        const stripped = stripJs(f.content);
+        for (const [open, close, name] of pairs) {
+            const o = countChar(stripped, open);
+            const c = countChar(stripped, close);
+            if (o !== c)
+                findings.push({ code: 'UNBALANCED_SYNTAX', severity: 'error', file: f.path, message: `unbalanced ${name} (${o} ${open} vs ${c} ${close})` });
+        }
+    }
+    return findings;
+}
+function stripJs(src) {
+    let out = '';
+    let i = 0;
+    while (i < src.length) {
+        const ch = src[i];
+        const next = src[i + 1];
+        if (ch === '/' && next === '/') {
+            while (i < src.length && src[i] !== '\n')
+                i++;
+            continue;
+        }
+        if (ch === '/' && next === '*') {
+            i += 2;
+            while (i < src.length && !(src[i] === '*' && src[i + 1] === '/'))
+                i++;
+            i += 2;
+            continue;
+        }
+        if (ch === '"' || ch === "'" || ch === '`') {
+            const quote = ch;
+            i++;
+            while (i < src.length && src[i] !== quote) {
+                if (src[i] === '\\')
+                    i++;
+                i++;
+            }
+            i++;
+            continue;
+        }
+        out += ch;
+        i++;
+    }
+    return out;
+}
+function countChar(s, ch) {
+    let n = 0;
+    for (const c of s)
+        if (c === ch)
+            n++;
+    return n;
+}
+function capabilityPresence(files) {
+    const capFile = files.find((f) => /config\/capabilities\.(ts|js)$/.test(f.path) || /conftest\.py$/.test(f.path));
+    if (!capFile) {
+        return [{ code: 'NO_CAPABILITIES', severity: 'warning', message: 'no capabilities/conftest file found in the generated suite' }];
+    }
+    const ok = /platformName/i.test(capFile.content) && /(UiAutomator2|XCUITest)/.test(capFile.content);
+    return ok ? [] : [{ code: 'INVALID_CAPABILITIES', severity: 'error', file: capFile.path, message: 'capability config missing platformName/automationName' }];
+}
+function emptyEssentials(files) {
+    const findings = [];
+    for (const f of files) {
+        if (/__init__\.py$/.test(f.path))
+            continue; // intentionally empty
+        if (f.content.trim() === '')
+            findings.push({ code: 'EMPTY_FILE', severity: 'warning', file: f.path, message: 'generated file is empty' });
+    }
+    return findings;
+}
+export function validateGeneratedSuite(files, opts = {}) {
+    const brittlePct = opts.brittlePct ?? 0;
+    const brittleThreshold = opts.brittleThreshold ?? 40;
+    const candidateOnly = opts.candidateOnly ?? false;
+    const findings = [];
+    const secretFindings = scanSecrets(files, opts.secrets ?? []);
+    findings.push(...secretFindings);
+    findings.push(...braceBalance(files));
+    findings.push(...capabilityPresence(files));
+    findings.push(...emptyEssentials(files));
+    // Locator durability threshold: a brittle-heavy suite is not release-grade unless explicitly
+    // labeled candidate-only.
+    if (brittlePct > brittleThreshold && !candidateOnly) {
+        findings.push({
+            code: 'BRITTLE_OVER_THRESHOLD',
+            severity: 'error',
+            message: `brittle locators ${brittlePct}% exceed the ${brittleThreshold}% threshold — add durable locators or label the suite candidate-only`,
+        });
+    }
+    else if (brittlePct > brittleThreshold && candidateOnly) {
+        findings.push({
+            code: 'BRITTLE_OVER_THRESHOLD',
+            severity: 'warning',
+            message: `brittle locators ${brittlePct}% exceed the ${brittleThreshold}% threshold — suite is labeled candidate-only`,
+        });
+    }
+    const ok = !findings.some((f) => f.severity === 'error');
+    return {
+        ok,
+        findings,
+        secretsClean: secretFindings.length === 0,
+        brittlePct,
+        brittleThreshold,
+        candidateOnly,
+        filesChecked: files.length,
+    };
+}
+//# sourceMappingURL=validation.js.map

package/dist/automationGen/validation.js.map

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

package/dist/build/parseBuildLog.js

@@ -0,0 +1,119 @@
+// Build-failure log parsing (Dev2 plan §4 "framework-specific build log parsing"). A build
+// that exits non-zero is an ENVIRONMENT/BUILD failure, never an app QA failure — but "build
+// failed" is useless to a developer. This module turns the captured build log into a typed
+// blocker with the LIKELY OWNER (app dev vs environment vs user) and a CONCRETE fix, plus the
+// relevant log tail (the lines that actually mention the error, not the whole transcript).
+//
+// PURE + testable: it only reads a log string + the step that produced it (no I/O), so the
+// signatures below are unit-testable against fixture logs without any real toolchain.
+/** Classify a build step into the tool whose log signatures we should match. */
+export function buildLogTool(step) {
+    if (!step)
+        return 'unknown';
+    const exe = step.argv[0] ?? '';
+    const cmd = step.command.toLowerCase();
+    const label = step.label.toLowerCase();
+    if (exe === 'xcodebuild')
+        return 'xcodebuild';
+    if (exe === 'flutter' && !label.includes('pub get'))
+        return 'flutter';
+    if (exe === 'pod' || label.includes('cocoapods'))
+        return 'cocoapods';
+    if (exe === './gradlew' || cmd.includes('gradlew'))
+        return 'gradle';
+    if (cmd.includes('expo run') || cmd.includes('expo prebuild'))
+        return 'expo';
+    if (exe === 'npm' || exe === 'yarn' || exe === 'pnpm' || label.includes('dependencies') || label.includes('pub get'))
+        return 'node-install';
+    return 'unknown';
+}
+// Ordered most-specific-first. Expo/Flutter android builds delegate to Gradle, so Gradle
+// signatures are also consulted for those tools (see SIGNATURES_BY_TOOL wiring below).
+const GRADLE_SIGNATURES = [
+    { name: 'sdk-location', test: /SDK location not found|ANDROID_HOME .* not|local\.properties/i, failureCode: 'GRADLE_FAILED', owner: 'environment', reason: 'Android SDK location not configured.', fix: 'Set ANDROID_HOME / sdk.dir (local.properties) to a valid Android SDK, then rebuild.' },
+    { name: 'sdk-platform-missing', test: /Failed to find target with hash string|Failed to find Build Tools|Could not (?:find|determine) .*(?:platforms|build-tools)|install the (?:missing )?platform/i, failureCode: 'GRADLE_FAILED', owner: 'environment', reason: 'Required Android SDK platform/build-tools are missing.', fix: 'Install the required SDK platform + build-tools via Android Studio SDK Manager or `sdkmanager`, then rebuild.' },
+    { name: 'sdk-license', test: /have not accepted the license|licenses? (?:have )?not.*accepted|to accept the SDK license/i, failureCode: 'GRADLE_FAILED', owner: 'environment', reason: 'Android SDK licenses are not accepted.', fix: 'Run `sdkmanager --licenses` (or accept licenses in Android Studio), then rebuild.' },
+    { name: 'ndk-missing', test: /NDK (?:is )?not configured|No version of NDK matched|Failed to install the following Android SDK packages.*ndk/i, failureCode: 'GRADLE_FAILED', owner: 'environment', reason: 'Required Android NDK is missing.', fix: 'Install the NDK version the project requests (SDK Manager / ndkVersion), then rebuild.' },
+    { name: 'signing', test: /Keystore file .* not found|Failed to read key .* from store|Could not (?:read|find) keystore|SigningConfig .* (?:is )?invalid|Failed to load signing config|keystore password was incorrect/i, failureCode: 'ANDROID_SIGNING_FAILED', owner: 'environment', reason: 'Gradle signing config (keystore) is missing or invalid.', fix: 'Provide a valid keystore + credentials, or build a debug variant (auto-signed with the debug keystore) for emulator QA.' },
+    { name: 'dependency-resolve', test: /Could not resolve|Could not find [^\n]*\.(?:jar|aar|pom)|Could not download|Failed to resolve:|Could not GET/i, failureCode: 'GRADLE_FAILED', owner: 'app', reason: 'A Gradle dependency could not be resolved/downloaded.', fix: 'Check the missing coordinate/repository and network access; fix the dependency declaration, then rebuild.' },
+    { name: 'compile', test: /error: cannot find symbol|Compilation (?:error|failed)|e: .*\.kt:|\.java:\d+: error:/i, failureCode: 'GRADLE_FAILED', owner: 'app', reason: 'A compile error in the app sources failed the Gradle build.', fix: 'Open the reported file/line in the log and fix the compile error, then rebuild.' },
+];
+const XCODE_SIGNATURES = [
+    { name: 'scheme-missing', test: /does not contain a scheme named|Scheme .* is not currently configured|The project .* does not contain a scheme/i, failureCode: 'XCODEBUILD_FAILED', owner: 'environment', reason: 'The requested Xcode scheme was not found.', fix: 'Pass the correct -scheme/-workspace (run `xcodebuild -list` to see schemes), then rebuild.' },
+    { name: 'signing', test: /Code Sign(?:ing)? error|requires a (?:development team|provisioning profile)|No (?:signing certificate|profiles for|account for team)|Signing for .* requires a development team/i, failureCode: 'XCODEBUILD_FAILED', owner: 'user', reason: 'Xcode code signing / provisioning is not configured.', fix: 'Set a development team and provisioning settings only if your simulator build configuration requires them.' },
+    { name: 'simulator-runtime', test: /Unable to find a destination|no simulator runtime|cannot be located on disk.*iphonesimulator|iOS \d+\.\d+ (?:simulator )?runtime (?:is )?not (?:installed|available)|Unsupported SDK/i, failureCode: 'SIMULATOR_RUNTIME_MISSING', owner: 'environment', reason: 'No usable iOS simulator runtime/destination for the build.', fix: 'Install a matching iOS simulator runtime in Xcode (Settings → Platforms) or pick an available destination, then rebuild.' },
+    { name: 'compile', test: /error: .*\.(?:m|mm|swift|h|c|cpp):|Command CompileC failed|Swift Compiler Error|fatal error: '.*' file not found/i, failureCode: 'XCODEBUILD_FAILED', owner: 'app', reason: 'A compile error in the iOS sources failed the build.', fix: 'Open the reported file/line in the xcodebuild log and fix the compile error, then rebuild.' },
+];
+const COCOAPODS_SIGNATURES = [
+    { name: 'pods-incompatible', test: /CocoaPods could not find compatible versions|Unable to find a specification for|could not find compatible versions for pod/i, failureCode: 'DEPENDENCY_INSTALL_REQUIRED', owner: 'app', reason: 'CocoaPods could not resolve compatible pod versions.', fix: 'Run `pod repo update` then `pod install`; adjust the Podfile constraints if the conflict persists.' },
+    { name: 'pods-out-of-sync', test: /sandbox is not in sync|run .?pod install.?|The .* Pods directory/i, failureCode: 'DEPENDENCY_INSTALL_REQUIRED', owner: 'environment', reason: 'CocoaPods sandbox is out of sync with the Podfile.', fix: 'Run `pod install` in the ios/ directory, then rebuild.' },
+];
+const FLUTTER_SIGNATURES = [
+    { name: 'sdk-missing', test: /Flutter SDK not found|command not found: flutter|Unable to locate the Flutter SDK|flutter: command not found/i, failureCode: 'BUILD_COMMAND_UNAVAILABLE', owner: 'environment', reason: 'The Flutter SDK is not available on PATH.', fix: 'Install Flutter and ensure `flutter` is on PATH (`flutter doctor`), then rebuild.' },
+    { name: 'pub-solve', test: /version solving failed|Because .* depends on|pub get failed|Could not (?:resolve|find package)/i, failureCode: 'DEPENDENCY_INSTALL_REQUIRED', owner: 'app', reason: 'Dart/Flutter package resolution (pub get) failed.', fix: 'Fix the pubspec.yaml version constraints, run `flutter pub get`, then rebuild.' },
+    { name: 'gradle-delegate', test: /Gradle task assemble\w+ failed|A problem occurred (?:configuring|evaluating) (?:root )?project/i, failureCode: 'GRADLE_FAILED', owner: 'app', reason: 'The Android Gradle build inside `flutter build` failed.', fix: 'Open the Gradle output in the log, fix the Android build error (SDK/dependency/signing), then rebuild.' },
+];
+const EXPO_SIGNATURES = [
+    { name: 'prebuild-required', test: /No native (?:android|ios) (?:project|directory)|run (?:npx )?expo prebuild|CNG|Continuous Native Generation|android.*directory.*(?:missing|not exist)/i, failureCode: 'EXPO_PREBUILD_REQUIRED', owner: 'swipium', reason: 'Expo project has no native directory to build.', fix: 'Run `npx expo prebuild` (or `npx expo run:*`, which prebuilds) to generate the native project, then rebuild.' },
+    { name: 'metro', test: /Unable to resolve module|Metro (?:bundler )?(?:has )?encountered|Cannot find module .* from .* Metro|Bundling failed/i, failureCode: 'METRO_FAILED', owner: 'app', reason: 'Metro bundling failed during the Expo build.', fix: 'Fix the unresolved module / bundling error (check imports + `node_modules`), then rebuild.' },
+    { name: 'config', test: /Invalid (?:app\.json|app config|Expo config)|ConfigError|Failed to read the app config/i, failureCode: 'BUILD_FAILED', owner: 'app', reason: 'Expo app config (app.json/app.config) is invalid.', fix: 'Fix the Expo config error reported in the log, then rebuild.' },
+];
+const NODE_INSTALL_SIGNATURES = [
+    { name: 'peer-conflict', test: /ERESOLVE|peer dep|unable to resolve dependency tree/i, failureCode: 'DEPENDENCY_INSTALL_REQUIRED', owner: 'app', reason: 'JS dependency resolution failed (peer/version conflict).', fix: 'Resolve the dependency conflict (align versions, or install with the appropriate flag), then re-run.' },
+    { name: 'network', test: /ETIMEDOUT|ENOTFOUND|network.*(?:error|timeout)|registry\.npmjs\.org/i, failureCode: 'DEPENDENCY_INSTALL_REQUIRED', owner: 'environment', reason: 'JS dependency install failed to reach the registry.', fix: 'Restore network/registry access, then re-run the dependency install.' },
+    { name: 'generic', test: /npm ERR!|error Command failed|ERR_PNPM|Cannot find module/i, failureCode: 'DEPENDENCY_INSTALL_REQUIRED', owner: 'environment', reason: 'JS dependency install failed.', fix: 'Read the install error in the log, fix it, then re-run the dependency install.' },
+];
+const SIGNATURES_BY_TOOL = {
+    gradle: GRADLE_SIGNATURES,
+    xcodebuild: XCODE_SIGNATURES,
+    // flutter / expo android builds delegate to Gradle, so append Gradle signatures after the
+    // framework-specific ones (framework signatures win when both match).
+    flutter: [...FLUTTER_SIGNATURES, ...GRADLE_SIGNATURES, ...XCODE_SIGNATURES],
+    expo: [...EXPO_SIGNATURES, ...GRADLE_SIGNATURES, ...XCODE_SIGNATURES],
+    cocoapods: COCOAPODS_SIGNATURES,
+    'node-install': NODE_INSTALL_SIGNATURES,
+    unknown: [],
+};
+/** Tool-default code/owner/fix when no specific signature matched. */
+function toolDefault(tool) {
+    switch (tool) {
+        case 'gradle': return { failureCode: 'GRADLE_FAILED', owner: 'app', reason: 'Gradle build failed.', fix: 'Open the Gradle log artifact and fix the reported error (SDK/dependency/compile/signing), then rebuild.' };
+        case 'xcodebuild': return { failureCode: 'XCODEBUILD_FAILED', owner: 'app', reason: 'xcodebuild failed.', fix: 'Open the xcodebuild log artifact and fix the reported error (scheme/signing/simulator/compile), then rebuild.' };
+        case 'flutter': return { failureCode: 'FLUTTER_BUILD_FAILED', owner: 'app', reason: 'flutter build failed.', fix: 'Open the flutter build log artifact and fix the reported error, then rebuild.' };
+        case 'cocoapods': return { failureCode: 'DEPENDENCY_INSTALL_REQUIRED', owner: 'environment', reason: 'CocoaPods install failed.', fix: 'Run `pod install` in the ios/ directory and resolve the reported error, then rebuild.' };
+        case 'expo': return { failureCode: 'BUILD_FAILED', owner: 'app', reason: 'Expo build failed.', fix: 'Open the build log artifact and fix the reported error, then rebuild.' };
+        case 'node-install': return { failureCode: 'DEPENDENCY_INSTALL_REQUIRED', owner: 'environment', reason: 'Dependency install failed.', fix: 'Read the install error in the log, fix it, then re-run.' };
+        default: return { failureCode: 'BUILD_FAILED', owner: 'app', reason: 'Build from source failed.', fix: 'Open the build log artifact, fix the compile/config error, then re-run. A build failure is NOT a test failure.' };
+    }
+}
+/**
+ * Extract the lines from a build log that actually describe the failure. Prefers lines that
+ * mention errors/failures; falls back to the last `maxLines` lines so the tail is never empty.
+ */
+export function relevantLogTail(log, maxLines = 30) {
+    const lines = log.split(/\r?\n/);
+    const errRe = /error|FAILURE|Could not|failed|fatal|ERR!|exception|✗|not found|unable to|requires/i;
+    const hits = lines.filter((l) => l.trim() && errRe.test(l));
+    const chosen = hits.length ? hits.slice(-maxLines) : lines.filter((l) => l.trim()).slice(-maxLines);
+    return chosen.join('\n').slice(-4000);
+}
+/**
+ * Analyze a failed build step's log into a typed, owned, actionable blocker. `timedOut` short-
+ * circuits to BUILD_TIMED_OUT (the log rarely explains a timeout). Otherwise we match the
+ * tool's signatures most-specific-first, then fall back to the tool default.
+ */
+export function analyzeBuildFailure(opts) {
+    const tool = buildLogTool(opts.step);
+    const relevantTail = relevantLogTail(opts.log);
+    if (opts.timedOut) {
+        return { failureCode: 'BUILD_TIMED_OUT', owner: 'environment', reason: 'Build exceeded its time budget.', tool, signal: 'timeout', relevantTail, fix: 'Increase the build timeout, warm caches, or build once manually then re-run against the artifact.' };
+    }
+    for (const sig of SIGNATURES_BY_TOOL[tool]) {
+        if (sig.test.test(opts.log)) {
+            return { failureCode: sig.failureCode, owner: sig.owner, reason: sig.reason, fix: sig.fix, relevantTail, signal: sig.name, tool };
+        }
+    }
+    const def = toolDefault(tool);
+    return { ...def, relevantTail, signal: null, tool };
+}
+//# sourceMappingURL=parseBuildLog.js.map

package/dist/build/parseBuildLog.js.map

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

package/dist/build/plan.js

@@ -0,0 +1,150 @@
+// Build-from-source planner (roadmap §4.5) — propose the EXACT commands that turn a source
+// project into an installable artifact, per framework + platform, with prerequisites
+// (dependency install, Expo prebuild, CocoaPods) and the artifact globs the build will produce.
+//
+// PURE planning: `buildPlan()` only reads the filesystem + checks toolchain presence. It never
+// runs a build. This makes command selection unit-testable, so an agent can show the plan and ask
+// minutes compiling.
+import { existsSync, readdirSync } from 'node:fs';
+import { join, basename } from 'node:path';
+import { detectFramework } from '../context/detect.js';
+import { which } from '../lib/android.js';
+function hasFile(root, ...rel) {
+    return rel.some((r) => existsSync(join(root, r)));
+}
+/** Pick the package manager from lockfiles (npm default). */
+function nodeInstallStep(root) {
+    const pm = existsSync(join(root, 'pnpm-lock.yaml'))
+        ? 'pnpm'
+        : existsSync(join(root, 'yarn.lock'))
+            ? 'yarn'
+            : 'npm';
+    const argv = pm === 'npm' ? ['npm', 'install'] : [pm, 'install'];
+    return { label: 'install JS dependencies', command: argv.join(' '), argv, cwd: root, optionalIfPresent: 'node_modules' };
+}
+/** Best-effort iOS scheme/workspace discovery for xcodebuild. */
+function iosWorkspace(root) {
+    const iosDir = existsSync(join(root, 'ios')) ? join(root, 'ios') : root;
+    let workspace;
+    let project;
+    try {
+        for (const f of readdirSync(iosDir)) {
+            if (f.endsWith('.xcworkspace'))
+                workspace = join(iosDir, f);
+            else if (f.endsWith('.xcodeproj'))
+                project = join(iosDir, f);
+        }
+    }
+    catch {
+        /* none */
+    }
+    const base = workspace ? basename(workspace, '.xcworkspace') : project ? basename(project, '.xcodeproj') : undefined;
+    return { workspace, project, scheme: base, dir: iosDir };
+}
+function podInstallStep(root) {
+    const iosDir = existsSync(join(root, 'ios')) ? join(root, 'ios') : root;
+    if (!existsSync(join(iosDir, 'Podfile')))
+        return null;
+    return { label: 'install CocoaPods', command: 'pod install', argv: ['pod', 'install'], cwd: iosDir, optionalIfPresent: 'Pods' };
+}
+function xcodebuildStep(root, variant) {
+    const { workspace, project, scheme, dir } = iosWorkspace(root);
+    const notes = [];
+    if (!scheme)
+        return { step: null, notes: ['Could not find an .xcworkspace/.xcodeproj — pass the scheme/workspace explicitly.'] };
+    const config = variant === 'release' ? 'Release' : 'Debug';
+    const argv = ['xcodebuild', '-scheme', scheme, '-sdk', 'iphonesimulator', '-configuration', config, '-derivedDataPath', 'build', 'build'];
+    if (workspace)
+        argv.splice(1, 0, '-workspace', basename(workspace));
+    else if (project)
+        argv.splice(1, 0, '-project', basename(project));
+    notes.push(`Using scheme "${scheme}" (best-effort) — override if your scheme differs.`);
+    return { step: { label: 'build iOS simulator app', command: argv.join(' '), argv, cwd: dir }, notes };
+}
+/**
+ * Produce a build plan for the given platform. Async because it checks toolchain presence.
+ */
+export async function buildPlan(opts) {
+    const { projectRoot: root, platform } = opts;
+    const variant = opts.variant ?? 'debug';
+    const framework = detectFramework(root);
+    const notes = [];
+    const prerequisites = [];
+    const missingToolchain = [];
+    const base = (over = {}) => ({
+        framework, platform, variant, prerequisites, build: null,
+        expectedArtifactGlobs: [], toolchainOk: missingToolchain.length === 0, missingToolchain, notes, ...over,
+    });
+    if (framework === 'unknown') {
+        return base({ failureCode: 'UNSUPPORTED_FRAMEWORK', notes: ['No supported mobile framework detected at this root.'] });
+    }
+    // Node-based frameworks need JS deps installed first.
+    const nodeBased = framework === 'expo' || framework === 'bare-react-native';
+    if (nodeBased)
+        prerequisites.push(nodeInstallStep(root));
+    if (platform === 'android') {
+        const apkGlobs = ['android/app/build/outputs/apk/**/*.apk', 'app/build/outputs/apk/**/*.apk'];
+        const flutterGlobs = ['build/app/outputs/flutter-apk/*.apk'];
+        const gradleArg = variant === 'release' ? 'assembleRelease' : 'assembleDebug';
+        switch (framework) {
+            case 'expo': {
+                // No native android dir → expo run:android prebuilds; otherwise it reuses it.
+                if (!hasFile(root, 'android'))
+                    notes.push('No android/ directory — expo run:android will prebuild it (EXPO_PREBUILD).');
+                const argv = ['npx', 'expo', 'run:android', '--variant', variant];
+                return base({ build: { label: 'build + run Android (Expo)', command: argv.join(' '), argv, cwd: root }, expectedArtifactGlobs: apkGlobs });
+            }
+            case 'bare-react-native':
+            case 'native-android': {
+                if (!hasFile(root, 'android/gradlew', 'gradlew')) {
+                    return base({ failureCode: 'BUILD_COMMAND_UNAVAILABLE', notes: ['No gradlew found — run from the Android project or add the Gradle wrapper.'] });
+                }
+                const cwd = existsSync(join(root, 'android')) ? join(root, 'android') : root;
+                const argv = ['./gradlew', gradleArg];
+                return base({ build: { label: `Gradle ${gradleArg}`, command: argv.join(' '), argv, cwd }, expectedArtifactGlobs: apkGlobs });
+            }
+            case 'flutter': {
+                if (!(await which('flutter')))
+                    missingToolchain.push('flutter');
+                prerequisites.unshift({ label: 'flutter pub get', command: 'flutter pub get', argv: ['flutter', 'pub', 'get'], cwd: root });
+                const argv = ['flutter', 'build', 'apk', `--${variant}`];
+                return base({ build: { label: 'flutter build apk', command: argv.join(' '), argv, cwd: root }, expectedArtifactGlobs: flutterGlobs, toolchainOk: missingToolchain.length === 0 });
+            }
+            default:
+                return base({ failureCode: 'BUILD_COMMAND_UNAVAILABLE' });
+        }
+    }
+    // ---- iOS (simulator-first) ----
+    const appGlobs = ['ios/build/**/*.app', 'build/**/*.app', 'build/ios/iphonesimulator/*.app'];
+    if (!(await which('xcodebuild')) && framework !== 'flutter')
+        missingToolchain.push('xcodebuild');
+    switch (framework) {
+        case 'expo': {
+            if (!hasFile(root, 'ios'))
+                notes.push('No ios/ directory — expo run:ios will prebuild it (EXPO_PREBUILD).');
+            const argv = ['npx', 'expo', 'run:ios', '--no-bundler'];
+            return base({ build: { label: 'build + run iOS simulator (Expo)', command: argv.join(' '), argv, cwd: root }, expectedArtifactGlobs: appGlobs });
+        }
+        case 'bare-react-native':
+        case 'native-ios': {
+            const pod = podInstallStep(root);
+            if (pod)
+                prerequisites.push(pod);
+            const { step, notes: xnotes } = xcodebuildStep(root, variant);
+            notes.push(...xnotes);
+            if (!step)
+                return base({ failureCode: 'BUILD_COMMAND_UNAVAILABLE' });
+            return base({ build: step, expectedArtifactGlobs: appGlobs });
+        }
+        case 'flutter': {
+            if (!(await which('flutter')))
+                missingToolchain.push('flutter');
+            prerequisites.unshift({ label: 'flutter pub get', command: 'flutter pub get', argv: ['flutter', 'pub', 'get'], cwd: root });
+            const argv = ['flutter', 'build', 'ios', '--simulator', `--${variant}`];
+            return base({ build: { label: 'flutter build ios --simulator', command: argv.join(' '), argv, cwd: root }, expectedArtifactGlobs: ['build/ios/iphonesimulator/*.app'], toolchainOk: missingToolchain.length === 0 });
+        }
+        default:
+            return base({ failureCode: 'BUILD_COMMAND_UNAVAILABLE' });
+    }
+}
+//# sourceMappingURL=plan.js.map

package/dist/build/plan.js.map

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

package/dist/ci/preflight.js

@@ -0,0 +1,85 @@
+import { ciMutationAllowed } from '../report/policy.js';
+const MUTATING_CI_STEPS = new Set(['networkOffline', 'networkOnline', 'seed', 'restartApp']);
+const VAR_REF = /\$\{([^}]+)\}/g;
+function variableBearingValues(step) {
+    switch (step.kind) {
+        case 'tap':
+            return [step.selector];
+        case 'tapOcrText':
+        case 'assertVisible':
+        case 'assertNotVisible':
+        case 'assertOcrText':
+        case 'scrollTo':
+        case 'waitForVisible':
+            return [step.query];
+        case 'wait':
+            return step.query ? [step.query] : [];
+        case 'inputText':
+            return [step.value, step.into].filter((v) => !!v);
+        case 'openUrl':
+            return [step.url];
+        case 'assertVisual':
+            return [step.description];
+        default:
+            return [];
+    }
+}
+export function ciMutatingSteps(flow) {
+    const all = [...flow.setup, ...flow.steps, ...flow.teardown];
+    const out = [];
+    all.forEach((step, i) => {
+        if (!MUTATING_CI_STEPS.has(step.kind))
+            return;
+        out.push({
+            flow: flow.name,
+            step: i + 1,
+            kind: step.kind,
+            reason: `${step.kind} changes device/app/test state and requires .swipium/policy.json ciAllowMutations`,
+        });
+    });
+    return out;
+}
+export function validateCiMutationPolicy(flows, policy) {
+    const violations = flows.flatMap((flow) => ciMutatingSteps(flow).filter((v) => !ciMutationAllowed(policy, v.kind)));
+    return { ok: violations.length === 0, violations };
+}
+export function ciRequiredVariables(flow) {
+    const all = [...flow.setup, ...flow.steps, ...flow.teardown];
+    const out = [];
+    all.forEach((step, i) => {
+        for (const value of variableBearingValues(step)) {
+            for (const match of value.matchAll(VAR_REF)) {
+                out.push({
+                    flow: flow.name,
+                    step: i + 1,
+                    kind: step.kind,
+                    variable: match[1],
+                    reason: `${step.kind} references \${${match[1]}}; set it in the CI environment before running Swipium.`,
+                });
+            }
+        }
+    });
+    return out;
+}
+export function validateCiVariables(flows, env = process.env, variables = {}) {
+    const missing = flows
+        .flatMap((flow) => ciRequiredVariables(flow))
+        .filter((v) => {
+        const explicit = variables[v.variable];
+        if (explicit != null && explicit !== '')
+            return false;
+        return env[v.variable] == null || env[v.variable] === '';
+    });
+    return { ok: missing.length === 0, missing };
+}
+export function validateCiParallelPack(pack) {
+    if (!pack.parallel)
+        return { ok: true, violations: [] };
+    return {
+        ok: false,
+        violations: [
+            `pack "${pack.name}" sets parallel:true, but CI pack execution currently uses one shared device/session/artifacts directory. Use parallel:false or run a device matrix with isolated simulator UDID, WDA port, artifacts dir, session id, and logs.`,
+        ],
+    };
+}
+//# sourceMappingURL=preflight.js.map

package/dist/ci/preflight.js.map

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