swipium 1.0.0

package/dist/oracle/health.js

@@ -0,0 +1,123 @@
+// Tier-1 deterministic health oracle (DESIGN §6). Phase 2.2: classifies BOTH layers —
+// NATIVE health (process: crash dialog / ANR / wrong foreground) and APP health (JS/UI:
+// RN RedBox / LogBox error / error-boundary fallback / WebView error). A green native
+// process with a broken app UI (e.g. an ErrorBoundary screen) is now a first-class finding,
+// so agents don't have to infer "healthy process but broken app" from raw snapshot text.
+import { parseSnapshot } from '../snapshot/parse.js';
+// APP-layer surfaces (JS/UI). Order matters: the first fatal RedBox variant wins over LogBox.
+const APP_SURFACES = [
+    { re: /unable to load script|could not connect to development server|loadJSBundleFromAssets|index\.android\.bundle/i, kind: 'rn_redbox', severity: 'high', detail: 'RN RedBox — JS bundle failed to load (Metro/bundle issue)' },
+    { re: /unhandled (js|javascript) exception|invariant violation|TypeError:|ReferenceError|undefined is not an object|is not a function/i, kind: 'rn_redbox', severity: 'high', detail: 'RN RedBox — unhandled JS exception' },
+    { re: /we encountered an error|something went wrong|this screen (crashed|encountered)|oops[!,. ].{0,40}(wrong|error|crash)/i, kind: 'app_error_boundary', severity: 'high', detail: 'app ErrorBoundary fallback UI (process alive, screen broken)' },
+    { re: /net::ERR_|webpage not available|this site can.?t be reached|ERR_INTERNET_DISCONNECTED|ERR_NAME_NOT_RESOLVED|ERR_CONNECTION/i, kind: 'webview_error', severity: 'medium', detail: 'WebView error page' },
+    { re: /console error|\b[1-9]\d* errors?\b/i, kind: 'rn_logbox_error', severity: 'medium', detail: 'RN LogBox error overlay (app running but logging errors)' },
+];
+// A conservative last-resort generic error surface (only when nothing more specific matched).
+const GENERIC_ERROR_RE = /failed to load|couldn.?t load|an error (occurred|has occurred)|no internet connection|please try again/i;
+// NATIVE-layer dialogs (process-level).
+const ANR_RE = /isn['’]t responding|application not responding/i;
+const CRASH_RE = /keeps stopping|has stopped|unfortunately/i;
+function firstMatch(nodes, re) {
+    for (const n of nodes) {
+        const t = `${n.text} ${n.desc} ${n.cls ?? ''} ${n.id ?? ''}`.trim();
+        if (re.test(t))
+            return (n.text || n.desc).trim().slice(0, 160);
+    }
+    return undefined;
+}
+export async function checkHealth(driver, appId, xml) {
+    const foreground = await driver.foregroundOwner().catch(() => 'unknown');
+    let source = xml;
+    if (source === undefined)
+        source = await driver.dumpXml().catch(() => '');
+    // Parse to nodes so evidence is the VISIBLE text (not attribute names) — best-effort.
+    let nodes = [];
+    try {
+        nodes = parseSnapshot(source).allNodes.map((n) => ({ text: n.text, desc: n.desc, cls: n.cls, id: n.id }));
+    }
+    catch {
+        nodes = [];
+    }
+    const joined = nodes.map((n) => `${n.text} ${n.desc} ${n.cls ?? ''} ${n.id ?? ''}`).join('  ') || source;
+    const findings = [];
+    // ---- NATIVE layer ----
+    let nativeStatus = 'ok';
+    if (driver.kind === 'wda' && !source) {
+        findings.push({ severity: 'high', layer: 'native', kind: 'wda_unreachable', detail: 'WebDriverAgent did not return a UI source' });
+        nativeStatus = 'wda_unreachable';
+    }
+    if (ANR_RE.test(joined)) {
+        findings.push({ severity: 'high', layer: 'native', kind: 'anr', detail: 'Application Not Responding dialog', evidence: firstMatch(nodes, ANR_RE) });
+        nativeStatus = 'anr';
+    }
+    else if (CRASH_RE.test(joined)) {
+        findings.push({ severity: 'high', layer: 'native', kind: 'native_crash', detail: 'native crash dialog', evidence: firstMatch(nodes, CRASH_RE) });
+        nativeStatus = 'native_crash';
+    }
+    if (driver.kind === 'wda') {
+        const springboard = /SpringBoard|XCUIElementTypeApplication[^]*com\.apple\.springboard/i.test(joined);
+        const alert = /XCUIElementTypeAlert/i.test(joined);
+        const permission = /would like to|allow|don.?t allow|while using|permission/i.test(joined) && alert;
+        if (springboard) {
+            findings.push({ severity: 'high', layer: 'native', kind: 'wrong_foreground_app', detail: 'iOS SpringBoard is foreground (app not active or crashed)', evidence: firstMatch(nodes, /SpringBoard/i) });
+            if (nativeStatus === 'ok')
+                nativeStatus = 'wrong_foreground_app';
+        }
+        else if (permission) {
+            findings.push({ severity: 'medium', layer: 'native', kind: 'permission_dialog', detail: 'iOS runtime permission dialog is visible', evidence: firstMatch(nodes, /would like to|allow|don.?t allow|while using|permission/i) });
+        }
+        else if (alert) {
+            findings.push({ severity: 'medium', layer: 'native', kind: 'native_alert', detail: 'iOS native alert is visible', evidence: firstMatch(nodes, /.+/) });
+        }
+    }
+    if (appId && !foreground.startsWith(appId) && foreground !== 'unknown') {
+        if (/launcher/i.test(foreground)) {
+            findings.push({ severity: 'high', layer: 'native', kind: 'wrong_foreground_app', detail: `app left to the launcher (possible crash) — foreground=${foreground}` });
+            if (nativeStatus === 'ok')
+                nativeStatus = 'wrong_foreground_app';
+        }
+        else if (/permissioncontroller/i.test(foreground)) {
+            findings.push({ severity: 'medium', layer: 'native', kind: 'permission_dialog', detail: `Android runtime permission dialog is visible — foreground=${foreground}` });
+        }
+        else if (/packageinstaller|systemui|com\.android\.|inputmethod/i.test(foreground)) {
+            findings.push({ severity: 'info', layer: 'native', kind: 'system_surface', detail: foreground });
+        }
+        else {
+            findings.push({ severity: 'medium', layer: 'native', kind: 'wrong_foreground_app', detail: `foreground is a different app — foreground=${foreground}` });
+            if (nativeStatus === 'ok')
+                nativeStatus = 'wrong_foreground_app';
+        }
+    }
+    // ---- APP layer (only meaningful while OUR app owns the foreground) ----
+    const appInForeground = !appId || foreground.startsWith(appId) || driver.kind === 'wda';
+    let appStatus = 'ok';
+    if (appInForeground) {
+        let matched = false;
+        for (const s of APP_SURFACES) {
+            if (s.re.test(joined)) {
+                findings.push({ severity: s.severity, layer: 'app', kind: s.kind, detail: s.detail, evidence: firstMatch(nodes, s.re) });
+                appStatus = s.severity === 'high' ? 'error' : appStatus === 'error' ? 'error' : 'degraded';
+                matched = true;
+                // RedBox/error-boundary are terminal for the screen — don't also report lesser surfaces.
+                if (s.severity === 'high')
+                    break;
+            }
+        }
+        if (!matched && GENERIC_ERROR_RE.test(joined)) {
+            findings.push({ severity: 'medium', layer: 'app', kind: 'unknown_error_surface', detail: 'generic error copy on screen (low confidence)', evidence: firstMatch(nodes, GENERIC_ERROR_RE) });
+            appStatus = 'degraded';
+        }
+    }
+    const nativeHealthy = !findings.some((f) => f.layer === 'native' && f.severity === 'high');
+    const appHealthy = appStatus === 'ok';
+    return {
+        healthy: !findings.some((f) => f.severity === 'high'),
+        nativeHealthy,
+        appHealthy,
+        nativeStatus,
+        appStatus,
+        foreground,
+        findings,
+    };
+}
+//# sourceMappingURL=health.js.map

package/dist/oracle/health.js.map

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

package/dist/oracle/record.js

@@ -0,0 +1,36 @@
+// Record health findings into the session for qa_report (review #3, Phase 2.2).
+// Shared by qa_act (auto after each action) and qa_check_health (on demand). Carries the
+// native/app layer + visible-text evidence, and — for app-layer error surfaces — captures
+// ONE screenshot as evidence and attaches its URI to those findings.
+export async function recordHealthFindings(sessions, session, findings, driver, screen) {
+    // Capture one screenshot of an app-layer error surface (RedBox / error-boundary / etc.)
+    // so the report shows WHAT broke, not just that something did. Evidence — not budgeted.
+    let evidenceUri;
+    const appError = findings.find((f) => f.layer === 'app' && (f.severity === 'high' || f.severity === 'medium'));
+    // Sensitive mode: record the finding but DON'T capture pixels.
+    if (appError && driver && !session.sensitive) {
+        try {
+            const png = await driver.screenshot();
+            evidenceUri = sessions.saveArtifact(session, 'screenshot', `app-error-${Date.now()}.png`, png, 'image/png', `app-health: ${appError.kind}`);
+        }
+        catch {
+            /* best-effort — evidence is a bonus, not required */
+        }
+    }
+    for (const f of findings) {
+        if (f.severity === 'info')
+            continue;
+        const screenshotUri = f.layer === 'app' ? (f.screenshotUri ?? evidenceUri) : f.screenshotUri;
+        sessions.addFinding(session, {
+            at: Date.now(),
+            severity: f.severity,
+            kind: f.kind,
+            detail: f.detail,
+            layer: f.layer,
+            evidence: f.evidence,
+            screen,
+            screenshotUri,
+        });
+    }
+}
+//# sourceMappingURL=record.js.map

package/dist/oracle/record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.js","sourceRoot":"","sources":["../../src/oracle/record.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,yFAAyF;AACzF,0FAA0F;AAC1F,qEAAqE;AAMrE,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,QAAsB,EACtB,OAAgB,EAChB,QAAmB,EACnB,MAAe,EACf,MAAe;IAEf,wFAAwF;IACxF,wFAAwF;IACxF,IAAI,WAA+B,CAAC;IACpC,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,IAAI,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC;IAC/G,+DAA+D;IAC/D,IAAI,QAAQ,IAAI,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;QAC7C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;YACtC,WAAW,GAAG,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,aAAa,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,eAAe,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9I,CAAC;QAAC,MAAM,CAAC;YACP,qDAAqD;QACvD,CAAC;IACH,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,CAAC,CAAC,QAAQ,KAAK,MAAM;YAAE,SAAS;QACpC,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;QAC7F,QAAQ,CAAC,UAAU,CAAC,OAAO,EAAE;YAC3B,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;YACd,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,MAAM;YACN,aAAa;SACd,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/orchestration/envelope.js

@@ -0,0 +1,52 @@
+// Uniform terminal result envelope for qa_test_this (Developer 1, roadmap §3.1 Milestone B).
+// Every terminal orchestration state — completed | blocked | unsafe | needs_input | running —
+// is summarizable from STRUCTURED output, with no log parsing: what was attempted, what safe
+// fallbacks were taken, which artifact/target was chosen and why, typed blockers with owner +
+// fix, the report URI, and the single exact next call.
+//
+// Developer 1 owns the ENVELOPE shape, not the source data: artifact/target explanations come
+// from Developer 2's services; suite/report/readiness summaries come from Developer 3's. This
+// module only normalizes those into one stable contract.
+import { FAILURES, failureOwner, isSelfFixable } from '../oracle/failures.js';
+/** Build a typed blocker from a Swipium failure code (owner + retry-safety + fix come from the
+ *  failure taxonomy, so an agent can route the blocker without a second lookup). */
+export function typedBlockerFromCode(code, override) {
+    const info = FAILURES[code];
+    if (!info) {
+        return {
+            failureCode: code,
+            owner: 'swipium',
+            retrySafe: true,
+            canSwipiumFix: false,
+            whatItMeans: 'Unrecognized failure code.',
+            howToFix: 'Inspect the run report; call qa_explain_blocker for guidance.',
+            ...override,
+        };
+    }
+    return {
+        failureCode: code,
+        owner: failureOwner(code),
+        retrySafe: info.retrySafe,
+        canSwipiumFix: isSelfFixable(code),
+        whatItMeans: info.summary,
+        howToFix: info.recovery,
+        ...override,
+    };
+}
+/** Normalize the orchestration outcome into the uniform terminal envelope (never throws). */
+export function buildTerminalEnvelope(input) {
+    return {
+        state: input.state,
+        sessionId: input.sessionId,
+        jobId: input.jobId ?? null,
+        summary: input.summary,
+        attempted: input.attempted ?? [],
+        workaroundsAttempted: input.workaroundsAttempted ?? [],
+        artifactChoice: input.artifactChoice ?? null,
+        targetChoice: input.targetChoice ?? null,
+        blockers: input.blockers ?? [],
+        reportUri: input.reportUri ?? null,
+        nextRecommendedAction: input.nextRecommendedAction ?? null,
+    };
+}
+//# sourceMappingURL=envelope.js.map

package/dist/orchestration/envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../../src/orchestration/envelope.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,8FAA8F;AAC9F,6FAA6F;AAC7F,8FAA8F;AAC9F,uDAAuD;AACvD,EAAE;AACF,8FAA8F;AAC9F,8FAA8F;AAC9F,yDAAyD;AAEzD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAoB,MAAM,uBAAuB,CAAC;AA6DhG;oFACoF;AACpF,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,QAAgC;IACjF,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAmB,CAAC,CAAC;IAC3C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;YACL,WAAW,EAAE,IAAI;YACjB,KAAK,EAAE,SAAS;YAChB,SAAS,EAAE,IAAI;YACf,aAAa,EAAE,KAAK;YACpB,WAAW,EAAE,4BAA4B;YACzC,QAAQ,EAAE,+DAA+D;YACzE,GAAG,QAAQ;SACZ,CAAC;IACJ,CAAC;IACD,OAAO;QACL,WAAW,EAAE,IAAI;QACjB,KAAK,EAAE,YAAY,CAAC,IAAmB,CAAC;QACxC,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,aAAa,EAAE,aAAa,CAAC,IAAmB,CAAC;QACjD,WAAW,EAAE,IAAI,CAAC,OAAO;QACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,GAAG,QAAQ;KACZ,CAAC;AACJ,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,qBAAqB,CAAC,KAAoB;IACxD,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,IAAI;QAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,EAAE;QAChC,oBAAoB,EAAE,KAAK,CAAC,oBAAoB,IAAI,EAAE;QACtD,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,IAAI;QAC5C,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,IAAI;QACxC,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE;QAC9B,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI;QAClC,qBAAqB,EAAE,KAAK,CAAC,qBAAqB,IAAI,IAAI;KAC3D,CAAC;AACJ,CAAC"}

package/dist/orchestration/goal.js

@@ -0,0 +1,98 @@
+// qa_test_this goal routing (Developer 1, roadmap §3.1 Milestone C). A `goal` adjusts ORCHESTRATION
+// FLAGS and REQUIRED OUTPUTS only — it never duplicates suite/report/platform logic (those stay in
+// the services Developer 2/3 own). Keeping the mapping a pure, exported helper makes goal behavior
+// unit-testable without a device, and keeps `qa_test_this` an orchestrator rather than a switchboard.
+export const TEST_GOALS = [
+    'smoke',
+    'explore',
+    'create_automation_suite',
+    'release_gate',
+    'test_login',
+    'reproduce_bug',
+];
+const BASE = {
+    smoke: {
+        explore: false,
+        generateSuite: false,
+        stopOnNeedsInput: false,
+        releaseGate: false,
+        requiredOutputs: ['reportUri', 'smoke'],
+        description: 'Fastest launch + guardrail/smoke path.',
+    },
+    explore: {
+        explore: true,
+        generateSuite: false,
+        stopOnNeedsInput: false,
+        releaseGate: false,
+        requiredOutputs: ['reportUri', 'smoke', 'exploration'],
+        description: 'Smoke, then guided exploration to map reachable workflows.',
+    },
+    create_automation_suite: {
+        explore: true,
+        generateSuite: true,
+        stopOnNeedsInput: false,
+        releaseGate: false,
+        requiredOutputs: ['reportUri', 'smoke', 'exploration', 'suite'],
+        description: 'Smoke + explore, then request a POM suite from the suite service.',
+    },
+    release_gate: {
+        explore: true,
+        generateSuite: false,
+        stopOnNeedsInput: false,
+        releaseGate: true,
+        requiredOutputs: ['reportUri', 'smoke', 'readiness'],
+        description: 'Stricter report + readiness/release-gate summary required.',
+    },
+    test_login: {
+        explore: false,
+        generateSuite: false,
+        stopOnNeedsInput: true,
+        releaseGate: false,
+        requiredOutputs: ['reportUri', 'smoke'],
+        description: 'Drive the login flow; stop for credentials if no secure inputs exist.',
+    },
+    reproduce_bug: {
+        explore: true,
+        generateSuite: false,
+        stopOnNeedsInput: false,
+        releaseGate: false,
+        requiredOutputs: ['reportUri', 'exploration'],
+        description: 'Focused exploration/test plan driven by a text goal.',
+    },
+};
+/**
+ * Resolve a goal into orchestration flags. Explicit per-flag overrides win, so existing callers
+ * passing `explore`/`generateSuite`/`stopOnNeedsInput` keep working unchanged.
+ *
+ * DEFAULT POLICY (no explicit goal): "leave behind automation when possible" — the run still does
+ * a fast launch + smoke, but ALSO attempts POM suite generation afterward (the suite service skips
+ * honestly when no actions were recorded). Opt out with `goal:"smoke"` (fast, explicit) or
+ * `policy.fastSmoke:true`.
+ */
+export function resolveGoalFlags(goal, overrides = {}, policy = {}) {
+    const explicit = goal !== undefined;
+    const g = goal ?? 'smoke';
+    const base = { ...BASE[g] };
+    if (!explicit) {
+        // Default autopilot: attempt automation. Stays fast (no forced exploration); suite generation
+        // is best-effort and skips when there are no recorded actions to turn into page objects.
+        base.generateSuite = true;
+        base.requiredOutputs = ['reportUri', 'smoke', 'suite'];
+        base.description = 'Default autopilot: fast launch + smoke, then generate a POM suite when actions exist (goal:"smoke" or fastSmoke:true to skip).';
+    }
+    if (policy.fastSmoke) {
+        // Strongest "just smoke, fast" signal — overrides the default automation attempt.
+        base.generateSuite = false;
+        base.explore = false;
+    }
+    return {
+        goal: g,
+        explore: overrides.explore ?? base.explore,
+        generateSuite: overrides.generateSuite ?? base.generateSuite,
+        stopOnNeedsInput: overrides.stopOnNeedsInput ?? base.stopOnNeedsInput,
+        releaseGate: base.releaseGate,
+        requiredOutputs: base.requiredOutputs,
+        description: base.description,
+    };
+}
+//# sourceMappingURL=goal.js.map

package/dist/orchestration/goal.js.map

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

package/dist/plan/plan.js

@@ -0,0 +1,124 @@
+// qa_plan core (PHASE3-PLAN §3.2) — PURE synthesis. Given what we detected about the
+// project + what the session declared (fixtures, observed auth, prepared appId), produce a
+// safe test plan: which workflows are READY, which are BLOCKED (and why + how to unblock),
+// and which are UNSAFE (and why). No device I/O lives here, so it is fully unit-testable;
+// the tool wrapper (src/tools/plan.ts) gathers the inputs and calls buildPlan().
+const LOGIN_FIXTURE = /login|auth|account|credential|sign[\s_-]?in/i;
+function isDebugRN(fw) {
+    return fw === 'expo' || fw === 'bare-react-native';
+}
+export function buildPlan(i) {
+    const ready = [];
+    const blocked = [];
+    const unsafe = [];
+    const notes = [];
+    const appAvailable = i.appPrepared || i.hasApk;
+    const loginFixture = i.fixtures.find((f) => LOGIN_FIXTURE.test(f.name) || !!f.testAccount);
+    // Shared gate: every workflow needs a device and the app present. Emit the right blocked
+    // entry once per workflow so the agent sees exactly what each one needs.
+    const gateEnv = (workflow, budgetProfile) => {
+        if (!i.hasDevice) {
+            return {
+                workflow,
+                budgetProfile,
+                category: 'missing_device',
+                requiredState: 'an online device or a bootable AVD',
+                recommendedSetup: 'Create/boot an AVD (see qa_doctor), then qa_prepare_target.',
+            };
+        }
+        if (!appAvailable) {
+            return {
+                workflow,
+                budgetProfile,
+                category: 'missing_artifact',
+                requiredState: 'the app installed, or a prebuilt app artifact to install',
+                recommendedSetup: 'Drop an APK under apps/android or a simulator .app under apps/ios, then run the platform prepare/attach flow.',
+            };
+        }
+        return null;
+    };
+    // launch_smoke — the cheapest always-valuable check.
+    {
+        const g = gateEnv('launch_smoke', 'guardrail');
+        if (g)
+            blocked.push(g);
+        else
+            ready.push({ workflow: 'launch_smoke', budgetProfile: 'guardrail', requires: [] });
+    }
+    // visual_smoke — screenshot/landmark check for visual-only (map/canvas) screens.
+    {
+        const g = gateEnv('visual_smoke', 'login_smoke');
+        if (g)
+            blocked.push(g);
+        else
+            ready.push({ workflow: 'visual_smoke', budgetProfile: 'login_smoke', requires: [] });
+    }
+    // login_smoke — needs a credential fixture on top of the env gate.
+    {
+        const g = gateEnv('login_smoke', 'login_smoke');
+        if (g)
+            blocked.push(g);
+        else if (!loginFixture) {
+            blocked.push({
+                workflow: 'login_smoke',
+                budgetProfile: 'login_smoke',
+                category: 'missing_test_data',
+                requiredState: 'a test account (credentials)',
+                recommendedSetup: 'Declare a fixture with a testAccount label (and provide TEST_EMAIL/TEST_PASSWORD via env), or add it to .swipium/fixtures.json.',
+            });
+        }
+        else {
+            ready.push({ workflow: 'login_smoke', budgetProfile: 'login_smoke', requires: [loginFixture.name] });
+        }
+    }
+    // Discovered flow files become first-class candidate workflows (PR5+).
+    for (const name of i.flows) {
+        const g = gateEnv(name, 'full_smoke');
+        if (g)
+            blocked.push(g);
+        else
+            ready.push({ workflow: name, budgetProfile: 'full_smoke', requires: [] });
+    }
+    // Fixtures that declare an unmet requiredState surface as blocked workflows so "no saved
+    // flight to delete" reads as setup guidance, not a failure (DESIGN §6 / qa_note semantics).
+    for (const f of i.fixtures) {
+        if (f.requiredState && !LOGIN_FIXTURE.test(f.name) && !f.testAccount) {
+            blocked.push({
+                workflow: f.name,
+                budgetProfile: 'full_smoke',
+                category: 'missing_test_data',
+                requiredState: f.requiredState,
+                recommendedSetup: f.recommendedSetup ?? `Create the precondition: ${f.requiredState}.`,
+            });
+        }
+    }
+    // UNSAFE — destructive actions that Swipium will refuse by default.
+    if (isDebugRN(i.framework)) {
+        unsafe.push({
+            workflow: 'fresh_start',
+            reason: 'bundle_cache_loss',
+            detail: 'clear_data / fresh_start wipes the JS bundle of a debug RN/Expo build, leaving a RedBox it cannot reload. Use a release APK (embedded bundle) for clean-state tests, or run destructive workflows last.',
+        });
+    }
+    if (!i.fixtures.some((f) => f.disposable === true || f.environment === 'test')) {
+        unsafe.push({
+            workflow: 'destructive_exploration',
+            reason: 'needs_disposable_state',
+            detail: 'Delete/pay/send/logout workflows require a fixture marked disposable:true or environment:"test" before Swipium can approve an exact destructive candidate.',
+        });
+    }
+    // Safety gates the agent should expect (informational; enforced server-side regardless).
+    const safetyGates = [
+        'Booting an emulator and installing an external APK each require one-time consent.',
+        'Network toggle (offline/online) requires consent and is auto-restored at qa_report.',
+        'Destructive app actions (clear_data/fresh_start) require consent; refused by default on debug RN/Expo builds.',
+        'Destructive exploration requires dry_run_destructive first, then candidate-bound approval with disposable test state.',
+    ];
+    if (i.auth.authedAtStart === false || i.auth.loginScreenSeen) {
+        notes.push('A login screen was observed — authenticated workflows will need credentials.');
+    }
+    for (const b of i.blockers)
+        notes.push(b);
+    return { ready, blocked, unsafe, safetyGates, notes };
+}
+//# sourceMappingURL=plan.js.map

package/dist/plan/plan.js.map

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

package/dist/prompts/index.js

@@ -0,0 +1,63 @@
+// MCP prompts (PHASE3-PLAN §2.4 / §3.3) — the spec's third server capability (after tools +
+// resources). Prompts are reusable workflow templates a prompt-capable client (e.g. Claude)
+// can invoke by name, so common QA runs don't need a hand-written prompt each time.
+//
+// Design rules:
+//  - Prompts are THIN: they only orchestrate tools that already exist. No privileged logic
+//    lives here — consent stays server-side (security best-practices doc).
+//  - Clients that don't support prompts lose nothing: every step is "call <tool>", which the
+//    agent can do directly. Nothing is prompt-only.
+//
+import { z } from 'zod';
+function userText(text) {
+    return { messages: [{ role: 'user', content: { type: 'text', text } }] };
+}
+export function registerPrompts(server) {
+    server.registerPrompt('swipium_setup_check', {
+        title: 'Check Swipium setup',
+        description: 'Verify Swipium can test a project and report what (if anything) is blocking.',
+        argsSchema: { projectRoot: z.string().optional().describe('Absolute path to the app project.') },
+    }, ({ projectRoot }) => userText(`Check whether Swipium can test ${projectRoot ? `the project at ${projectRoot}` : 'this project'}.\n\n` +
+        `1. Call qa_doctor to confirm the toolchain (adb/emulator/java) and that the client is not stale.\n` +
+        `2. Call qa_start_session${projectRoot ? ` { projectRoot: "${projectRoot}" }` : ''}.\n` +
+        `3. Call qa_detect_context, then qa_plan with the sessionId.\n` +
+        `4. Summarize: is it READY, PARTIAL, or BLOCKED? List the exact missing items (APK, device, credentials) and the recommended budget profile. Do not start testing yet.`));
+    server.registerPrompt('swipium_full_smoke', {
+        title: 'Run a full smoke test',
+        description: 'Plan, prepare, run the top ready workflows, and produce a report.',
+        argsSchema: {
+            projectRoot: z.string().optional(),
+            appId: z.string().optional().describe('Override the auto-detected app id.'),
+        },
+    }, ({ projectRoot, appId }) => userText(`Run a full smoke test and produce a report a developer can act on.\n\n` +
+        `1. qa_start_session${projectRoot ? ` { projectRoot: "${projectRoot}", ` : ' { '}profile: "full_smoke", responseMode: "compact" }.\n` +
+        `2. qa_plan — pick the READY workflows; respect anything listed as UNSAFE.\n` +
+        `3. qa_prepare_target${appId ? ` { appId: "${appId}" }` : ''} (approve consent for boot/install if prompted).\n` +
+        `4. For each ready workflow: drive it with qa_snapshot/qa_act, checking qa_check_health after key steps. Use qa_clear_overlay if a keyboard/dialog/banner blocks a target.\n` +
+        `5. Record each result with qa_note (pass/fail/blocked + category). For visual-only screens use qa_assert_visual.\n` +
+        `6. qa_report at the end. Summarize release risk and the single most important next action.`));
+    server.registerPrompt('swipium_bug_repro', {
+        title: 'Reproduce and document a bug',
+        description: 'Drive to a described bug, capture deterministic evidence, and file it as a structured outcome.',
+        argsSchema: {
+            bug: z.string().describe('What the bug is / how to reach it.'),
+            projectRoot: z.string().optional(),
+        },
+    }, ({ bug, projectRoot }) => userText(`Reproduce and document this bug with evidence:\n"${bug}"\n\n` +
+        `1. qa_start_session${projectRoot ? ` { projectRoot: "${projectRoot}", ` : ' { '}profile: "login_smoke" }, then qa_plan.\n` +
+        `2. qa_prepare_target, then navigate toward the reported bug with qa_snapshot/qa_act.\n` +
+        `3. At the failure, call qa_check_health (capture native vs app classification) and qa_screenshot for evidence.\n` +
+        `4. Record qa_note { outcome: "fail", category: "app_bug", reason, artifactUris } — or "blocked"/"not_applicable" if you could not reach it, with the precondition.\n` +
+        `5. qa_report. Include exact reproduction steps and the evidence artifact URIs so the report stands alone without the transcript.`));
+    server.registerPrompt('swipium_convert_run_to_flow', {
+        title: 'Convert a run into a reusable flow',
+        description: 'Draft a repeatable .swipium/flows/*.yaml from the steps you just performed, then validate it.',
+        argsSchema: { name: z.string().optional().describe('Flow name, e.g. login-smoke.') },
+    }, ({ name }) => userText(`Turn the workflow you just ran into a repeatable Swipium flow.\n\n` +
+        `1. Write a flow YAML named "${name ?? 'my-flow'}" with: name, appId, budgetProfile, fixtures, and a steps list.\n` +
+        `2. Use durable selectors: prefer text/id (e.g. tap: "Sign In") over @ref. Replace credentials with \${TEST_EMAIL}/\${TEST_PASSWORD} variables — never inline secrets.\n` +
+        `   Available steps: prepareTarget, tap, tapAt, inputText, assertVisible, assertNotVisible, swipe, scrollTo, press, openUrl, wait.\n` +
+        `3. Validate it with qa_flow_check { flowYaml: "<your yaml>" } and fix any reported errors.\n` +
+        `4. Save it under .swipium/flows/${name ?? 'my-flow'}.yaml so qa_plan lists it and qa_flow_run can replay it.`));
+}
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

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

package/dist/report/artifactManifest.js

@@ -0,0 +1,44 @@
+import { createHash } from 'node:crypto';
+import { existsSync, readFileSync, statSync } from 'node:fs';
+function sha256(path) {
+    return createHash('sha256').update(readFileSync(path)).digest('hex');
+}
+export function buildSessionArtifactManifest(session) {
+    const files = [];
+    const missing = [];
+    const artifactCounts = session.artifacts.reduce((acc, a) => {
+        acc[a.kind] = (acc[a.kind] ?? 0) + 1;
+        return acc;
+    }, {});
+    for (const a of session.artifacts) {
+        if (!existsSync(a.path)) {
+            missing.push({ uri: a.uri, path: a.path, kind: a.kind });
+            continue;
+        }
+        const st = statSync(a.path);
+        files.push({
+            uri: a.uri,
+            kind: a.kind,
+            label: a.label,
+            mime: a.mime,
+            path: a.path,
+            bytes: st.size,
+            sha256: sha256(a.path),
+            createdAt: new Date(a.createdAt).toISOString(),
+        });
+    }
+    return {
+        schemaVersion: 1,
+        sessionId: session.id,
+        createdAt: new Date().toISOString(),
+        root: session.root,
+        device: session.device ?? null,
+        appId: session.appId ?? null,
+        sensitive: session.sensitive,
+        artifactCounts,
+        files,
+        missing,
+        environmentMutations: session.envChanges,
+    };
+}
+//# sourceMappingURL=artifactManifest.js.map

package/dist/report/artifactManifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifactManifest.js","sourceRoot":"","sources":["../../src/report/artifactManifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AA0B7D,SAAS,MAAM,CAAC,IAAY;IAC1B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,OAAgB;IAC3D,MAAM,KAAK,GAAqC,EAAE,CAAC;IACnD,MAAM,OAAO,GAAuC,EAAE,CAAC;IACvD,MAAM,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,MAAM,CAAyB,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QACjF,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACrC,OAAO,GAAG,CAAC;IACb,CAAC,EAAE,EAAE,CAAC,CAAC;IACP,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QAClC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACzD,SAAS;QACX,CAAC;QACD,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC;YACT,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,KAAK,EAAE,EAAE,CAAC,IAAI;YACd,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;YACtB,SAAS,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE;SAC/C,CAAC,CAAC;IACL,CAAC;IACD,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,SAAS,EAAE,OAAO,CAAC,EAAE;QACrB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;QAC9B,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,IAAI;QAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,cAAc;QACd,KAAK;QACL,OAAO;QACP,oBAAoB,EAAE,OAAO,CAAC,UAAU;KACzC,CAAC;AACJ,CAAC"}