swipium 1.5.0 → 2.0.1

package/dist/tools/metro.js

@@ -1,4 +1,4 @@
-// qa_metro — own the debug React Native / Expo Metro flow (review §4.2 / Rec 5).
+// qa_metro: own the debug React Native / Expo Metro flow (review §4.2 / Rec 5).
 // A debug RN/Expo APK needs a Metro dev server on :8081 + `adb reverse` to fetch its JS
 // bundle. `status` reports whether that's ready; `start` (consent-gated) sets up the
 // reverse and launches Metro, logging to a session artifact.
@@ -6,7 +6,7 @@ import { z } from 'zod';
 import { openSync, closeSync } from 'node:fs';
 import { join } from 'node:path';
 import { spawn, spawnSync } from 'node:child_process';
-import { qaOk, qaError } from '../lib/result.js';
+import { qaOk, qaError, unknownSessionError } from '../lib/result.js';
 import { requireConsent, consumeConsent } from '../consent/consent.js';
 import { run } from '../lib/spawn.js';
 import { detectFramework } from '../context/detect.js';
@@ -14,17 +14,18 @@ import { METRO_PORT, metroReadiness } from '../lib/metroState.js';
 import { parseSnapshot } from '../snapshot/parse.js';
 import { detectRedBox } from '../snapshot/overlays.js';
 import { getDriver, resolveDevice, bindDevice } from '../session/attach.js';
-import { registerManagedProcess, unregisterManagedProcess } from '../session/processRegistry.js';
+import { psEnv, registerManagedProcess, unregisterManagedProcess } from '../session/processRegistry.js';
 /** True if `pid` is a live process whose command looks like a Metro/Expo/RN bundler. Guards
- * against killing a recycled PID — e.g. a `metroPid` persisted before a machine or server
- * restart that now belongs to an unrelated process. Best-effort (POSIX `ps`); on any doubt
+ * against killing a recycled PID (e.g. a `metroPid` persisted before a machine or server
+ * restart that now belongs to an unrelated process). Best-effort (POSIX `ps`); on any doubt
  * we report "not ours" so we never signal a stranger. */
 function metroProcessLooksAlive(pid) {
     try {
-        const out = spawnSync('ps', ['-o', 'command=', '-p', String(pid)], { encoding: 'utf8' });
+        const out = spawnSync('ps', ['-o', 'command=', '-p', String(pid)], { encoding: 'utf8', env: psEnv() });
         if (out.status !== 0 || !out.stdout)
             return false;
-        return /metro|expo|react-native|node/i.test(out.stdout);
+        // `npm exec …`: npx retitles itself after spawn (the launcher we recorded as metroPid).
+        return /metro|expo|react-native|node|npm exec/i.test(out.stdout);
     }
     catch {
         return false;
@@ -40,7 +41,7 @@ function killMetroGroup(pid) {
         return true;
     }
     catch {
-        /* not a group leader, or group already gone — fall through */
+        /* not a group leader, or group already gone, fall through */
     }
     try {
         process.kill(pid, 'SIGTERM');
@@ -73,7 +74,9 @@ function metroCommand(framework) {
 export function registerMetro(server, sessions) {
     server.registerTool('qa_metro', {
         title: 'Metro dev server (debug RN/Expo)',
-        description: 'For debug React Native / Expo builds that need a Metro bundler on :8081. action="status" reports Metro/reverse/serving state; action="diagnose" adds RedBox detection + logcat evidence + a recovery roadmap (incl. whether reinstall/rebuild is required); action="start" (consent-gated) runs `adb reverse tcp:8081 tcp:8081` + launches Metro, logging to a session artifact + tracking its PID; action="stop" kills it + removes the reverse. After start, wait a few seconds then relaunch with qa_prepare_target.',
+        description: 'Metro bundler for debug React Native / Expo builds (:8081). status: Metro/reverse/serving state; diagnose: + RedBox ' +
+            'detection, logcat evidence, and recovery steps; start (consent-gated): adb reverse + launch Metro with a log artifact; ' +
+            'stop: kill it + remove the reverse. After start, relaunch with qa_prepare_target.',
         inputSchema: {
             sessionId: z.string(),
             action: z.enum(['status', 'diagnose', 'start', 'stop']),
@@ -83,20 +86,16 @@ export function registerMetro(server, sessions) {
     }, async ({ sessionId, action, consentId, approve }) => {
         const session = sessions.get(sessionId);
         if (!session)
-            return qaError({
-                what: `Unknown sessionId ${sessionId}`,
-                changedState: false,
-                retrySafe: true,
-                nextSteps: ['Call qa_start_session first.'],
-            });
+            return unknownSessionError(sessionId);
         // Centralized device resolution (P0.1/P0.3): use the session device, else the single
-        // online one (bind it), else ask / guide — never a circular "no device" dead end.
+        // online one (bind it), else ask / guide. Never a circular "no device" dead end.
         const dev = await resolveDevice(session);
         if (dev.needSelection && action !== 'status') {
             return qaError({
-                what: 'Multiple devices online — choose one',
+                what: 'Multiple devices online, choose one',
                 changedState: false,
                 retrySafe: true,
+                failureCode: 'MULTIPLE_DEVICES',
                 nextSteps: [`Re-run qa_prepare_target with device="<serial>". Online: ${dev.available.join(', ')}`],
             });
         }
@@ -110,7 +109,7 @@ export function registerMetro(server, sessions) {
         if (action === 'status') {
             const deviceHint = serial
                 ? ''
-                : '\n⚠ No device bound — adb reverse needs one. Call qa_prepare_target first (it binds the device), then qa_metro.';
+                : '\n⚠ No device bound; adb reverse needs one. Call qa_prepare_target first (it binds the device), then qa_metro.';
             return qaOk({
                 framework: fw,
                 metroListening: listening,
@@ -125,8 +124,8 @@ export function registerMetro(server, sessions) {
                 needsDevice: !serial,
             }, `framework=${fw} metro:${METRO_PORT}=${listening ? 'listening' : 'down'} serving=${rd.serving} adb-reverse=${serial ? (reverseSet ? 'set' : 'unset') : 'n/a (no device)'} device=${serial ?? 'none'} online=[${dev.available.join(',')}]${session.metroPid ? ` pid=${session.metroPid}` : ''}` +
                 (rd.ready
-                    ? '\nReady — debug bundle can load.'
-                    : deviceHint || '\nNot fully ready — run qa_metro action="start" (or qa_metro diagnose).'));
+                    ? '\nReady: debug bundle can load.'
+                    : deviceHint || '\nNot fully ready. Run qa_metro action="start" (or qa_metro diagnose).'));
         }
         if (action === 'diagnose') {
             const { driver } = await getDriver(session);
@@ -148,23 +147,23 @@ export function registerMetro(server, sessions) {
             let requiresReinstall = false;
             if (!serial)
                 recovery.push(dev.needSelection
-                    ? `Multiple devices online — re-run qa_prepare_target device="<serial>". Online: ${dev.available.join(', ')}`
-                    : 'No device online — boot one via qa_prepare_target (it boots + sets reverse), then retry.');
+                    ? `Multiple devices online. Re-run qa_prepare_target device="<serial>". Online: ${dev.available.join(', ')}`
+                    : 'No device online. Boot one via qa_prepare_target (it boots + sets reverse), then retry.');
             if (!listening)
                 recovery.push('Start Metro: qa_metro action="start".');
             if (serial && listening && !reverseSet)
                 recovery.push('Set reverse: qa_metro action="start" (sets adb reverse).');
             if (listening && !rd.serving)
-                recovery.push('Metro is up but not serving the bundle yet — wait ~10s for the first transform, then retry.');
+                recovery.push('Metro is up but not serving the bundle yet. Wait ~10s for the first transform, then retry.');
             if (redbox.unableToLoadScript) {
                 requiresReinstall = true;
-                recovery.push('RedBox is "Unable to load script": the installed build cannot fetch the JS bundle. If Metro+reverse are ready and it still fails, the APK is bundle-less/asset-only — RECOVERY REQUIRES REINSTALL/REBUILD of a working debug or release APK (a data wipe alone will not fix it).');
+                recovery.push('RedBox is "Unable to load script": the installed build cannot fetch the JS bundle. If Metro+reverse are ready and it still fails, the APK is bundle-less/asset-only. RECOVERY REQUIRES REINSTALL/REBUILD of a working debug or release APK (a data wipe alone will not fix it).');
             }
             else if (redbox.present) {
                 recovery.push('RedBox present (not load-script): tap RELOAD via qa_act, or fix the JS error shown.');
             }
             if (rd.ready && !redbox.present)
-                recovery.push('Metro ready and no RedBox — the bundle should load.');
+                recovery.push('Metro ready and no RedBox. The bundle should load.');
             return qaOk({
                 framework: fw,
                 ...rd,
@@ -177,7 +176,7 @@ export function registerMetro(server, sessions) {
                 recovery,
             }, `framework=${fw} | metro listening=${rd.listening} serving=${rd.serving} reverse=${reverseSet} ready=${rd.ready}\n` +
                 `redbox=${redbox.present ? (redbox.unableToLoadScript ? 'UNABLE-TO-LOAD-SCRIPT' : 'present') : 'none'}${requiresReinstall ? ' ⚠ requires reinstall/rebuild' : ''}\n` +
-                `recovery:\n - ${recovery.join('\n - ') || '(none — looks healthy)'}` +
+                `recovery:\n - ${recovery.join('\n - ') || '(none, looks healthy)'}` +
                 (logUri ? `\nlogcat evidence: ${logUri}` : ''));
         }
         if (action === 'stop') {
@@ -214,20 +213,21 @@ export function registerMetro(server, sessions) {
                 ? `Stopped Metro pid ${had}${killed ? '' : ' (was already gone)'}; removed adb reverse.`
                 : 'No Swipium-started Metro to stop (it may have been started externally).');
         }
-        // action === 'start' — `serial` is the single online device (auto-bound) or a session
+        // action === 'start': `serial` is the single online device (auto-bound) or a session
         // device. If none online, guide to prepare_target to BOOT (terminal, non-circular).
         if (!serial) {
             return qaError({
-                what: dev.needSelection ? 'Multiple devices online — choose one' : 'No device online — Metro reverse needs a running device',
+                what: dev.needSelection ? 'Multiple devices online, choose one' : 'No device online. Metro reverse needs a running device',
                 changedState: false,
                 retrySafe: true,
+                failureCode: dev.needSelection ? 'MULTIPLE_DEVICES' : 'NO_DEVICE',
                 nextSteps: dev.needSelection
                     ? [`Re-run qa_prepare_target device="<serial>". Online: ${dev.available.join(', ')}`]
                     : ['Boot a device first: qa_prepare_target { bindOnly:true } (boots an AVD + sets reverse), then qa_metro start.'],
             });
         }
         if (listening && reverseSet) {
-            return qaOk({ framework: fw, metroListening: true, reverseSet: true, alreadyRunning: true }, 'Metro already listening and adb reverse already set — nothing to do.');
+            return qaOk({ framework: fw, metroListening: true, reverseSet: true, alreadyRunning: true }, 'Metro already listening and adb reverse already set, nothing to do.');
         }
         const { cmd, args } = metroCommand(fw);
         const cmdStr = `adb -s ${serial} reverse tcp:${METRO_PORT} tcp:${METRO_PORT} && (cd ${session.root} && ${cmd} ${args.join(' ')})`;
@@ -236,14 +236,14 @@ export function registerMetro(server, sessions) {
             sessions.recordMutation(session, {
                 tool: 'qa_metro',
                 action: 'start_metro',
-                risk: 'low',
+                risk: 'medium',
                 target: { device: serial, port: METRO_PORT, framework: fw },
                 consent: { required: true, approved: false },
                 status: 'requested',
             });
             return requireConsent({
                 action: 'start_metro',
-                risk: 'low',
+                risk: 'medium',
                 exactCommand: cmdStr,
                 affects: { port: METRO_PORT, framework: fw },
                 explain: `This looks like a debug ${fw} build needing Metro on :${METRO_PORT}. Set adb reverse and start Metro?`,
@@ -252,7 +252,7 @@ export function registerMetro(server, sessions) {
         sessions.recordMutation(session, {
             tool: 'qa_metro',
             action: 'start_metro',
-            risk: 'low',
+            risk: 'medium',
             target: { device: serial, port: METRO_PORT, framework: fw },
             consent: { required: true, consentId, approved: true },
             status: 'approved',
@@ -265,7 +265,7 @@ export function registerMetro(server, sessions) {
             sessions.recordMutation(session, {
                 tool: 'qa_metro',
                 action: 'start_metro',
-                risk: 'low',
+                risk: 'medium',
                 target: { device: serial, port: METRO_PORT, framework: fw },
                 consent: { required: true, consentId, approved: true },
                 status: 'blocked',
@@ -276,6 +276,7 @@ export function registerMetro(server, sessions) {
                 commandAttempted: `adb -s ${serial} reverse tcp:${METRO_PORT} tcp:${METRO_PORT}`,
                 changedState: true,
                 retrySafe: true,
+                failureCode: 'METRO_FAILED',
                 nextSteps: ['Check the device is online.'],
             });
         }
@@ -293,13 +294,13 @@ export function registerMetro(server, sessions) {
         sessions.recordMutation(session, {
             tool: 'qa_metro',
             action: 'start_metro',
-            risk: 'low',
+            risk: 'medium',
             target: { device: serial, port: METRO_PORT, framework: fw, pid: child.pid ?? null },
             consent: { required: true, consentId, approved: true },
             status: 'executed',
             ledgerUri: logUri,
         });
-        return qaOk({ framework: fw, started: true, port: METRO_PORT, reverseSet: true, pid: child.pid, logUri, logPath }, `Started Metro (${fw}) on :${METRO_PORT} + adb reverse set. Log → ${logUri}\nWait ~5–10s for "Metro waiting", then relaunch the app with qa_prepare_target.`);
+        return qaOk({ framework: fw, started: true, port: METRO_PORT, reverseSet: true, pid: child.pid, logUri, logPath }, `Started Metro (${fw}) on :${METRO_PORT} + adb reverse set. Log: ${logUri}\nWait ~5-10s for "Metro waiting", then relaunch the app with qa_prepare_target.`);
     });
 }
 //# sourceMappingURL=metro.js.map

package/dist/tools/metro.js.map

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

package/dist/tools/mobileAudit.js

@@ -1,18 +1,18 @@
-// SWIPIUM Mobile QA Toolkit MCP tool (SWIPIUM-REQ-07). qa_mobile_audit turns a named profile
+// SWIPIUM Mobile QA Toolkit MCP tool. qa_mobile_audit turns a named profile
 // (smoke | account_cycle | store_compliance | resilience | release_gate) into an ordered, classified
 // checklist plus the account-cycle safety contract the agent executes with the existing driver tools.
 // It also surfaces the issue-ledger recurrence state so a release gate sees regressions. Thin wrapper
 // over src/mobileAudit/* and src/issues/*.
 import { z } from 'zod';
-import { qaOk, qaError } from '../lib/result.js';
-import { resolveProjectRoot } from '../context/projectRoot.js';
-import { getDriver } from '../session/attach.js';
+import { qaOk, qaError, unknownSessionError } from '../lib/result.js';
+import { resolveProjectRoot, unresolvedProjectRootError } from '../context/projectRoot.js';
+import { blockedDeviceResult, getDriver } from '../session/attach.js';
 import { accountCycleSafety, checksForProfile, ALL_PROFILES } from '../mobileAudit/profiles.js';
-import { runMobileAudit } from '../mobileAudit/runner.js';
+import { auditChangesNetwork, auditNetworkConsentRequest, runMobileAudit } from '../mobileAudit/runner.js';
+import { consumeConsent, requireConsent } from '../consent/consent.js';
 import { auditRunToMarkdown } from '../mobileAudit/results.js';
 import { generateSessionReport } from '../services/report.js';
 import { queryIssues } from '../issues/index.js';
-import { issuesResourceUri } from '../issues/store.js';
 import { resolveSourceRevision } from '../issues/sourceRevision.js';
 import { loadPolicy } from '../issues/store.js';
 function nowIso() {
@@ -22,7 +22,7 @@ async function rootFor(server, sessions, args) {
     if (args.sessionId) {
         const s = sessions.get(args.sessionId);
         if (!s)
-            return { hint: `Unknown sessionId ${args.sessionId}` };
+            return { error: unknownSessionError(args.sessionId) };
         return { root: s.root };
     }
     const resolved = await resolveProjectRoot(server, args.projectRoot);
@@ -33,45 +33,31 @@ async function rootFor(server, sessions, args) {
 export function registerMobileAudit(server, sessions) {
     server.registerTool('qa_mobile_audit', {
         title: 'Mobile QA release audit',
-        description: 'USE WHEN asked for a release-readiness, store-compliance, or account-lifecycle audit: plan or execute a named mobile-QA audit profile. mode:"plan" (default) returns the ordered checklist + safety contract WITHOUT driving the device; mode:"execute" requires a sessionId with a prepared device, drives every check, records issue-ledger entries with evidence for fail/blocked checks, and returns per-check results + a release-impact decision (+ best-effort report URI). Profile meanings and the safety contract are documented on the `profile` and `allowGeneratedData` params. A check never reports pass without observed evidence.',
+        description: 'Plan or execute a release audit. profile: smoke, account_cycle (create > logout > login > forgot-password on a ' +
+            'DISPOSABLE generated account), store_compliance (privacy/terms/account deletion/subscription/paywall), resilience ' +
+            '(offline/relaunch/rotation; airplane toggle is consent-gated, original network restored), release_gate (all + locator readiness + issue recurrence). mode:"plan" ' +
+            '(default) returns the checklist + safety contract without the device; "execute" (prepared session) runs every check, ' +
+            'logs fail/blocked checks to the issue ledger with evidence, and returns release impact. No check passes without ' +
+            'evidence.',
         inputSchema: {
             projectRoot: z.string().optional(),
             sessionId: z.string().optional(),
-            profile: z
-                .enum(ALL_PROFILES)
-                .describe('Audit profile: smoke (launch/health/nav) · account_cycle (create → logout → login-again → forgot-password on a DISPOSABLE generated account; needs allowGeneratedData) · store_compliance (privacy/terms/account-deletion/subscription/paywall) · resilience (offline/restore/relaunch/rotation — network is always restored) · release_gate (all profiles + locator readiness + issue-ledger recurrence).'),
-            mode: z
-                .enum(['plan', 'execute'])
-                .optional()
-                .describe('plan (default): return the ordered checklist (expected behavior + report classification), the account-cycle safety contract, and an `executor` handoff — no device is touched. execute: drive the audit against the attached device, record issues + evidence, and return per-check MobileAuditCheckResults + release impact.'),
-            allowGeneratedData: z
-                .boolean()
-                .optional()
-                .describe('Permit safe generated disposable-account data (test/staging only). Safety contract: logout is permitted only inside the controlled account-cycle workflow on the disposable account; delete/pay/send stay refused; a real account is never deleted; OTP/MFA returns needs_input.'),
-            allowTestAccountDeletion: z
-                .boolean()
-                .optional()
-                .describe('Permit destructive cleanup of disposable test accounts only (never a real account).'),
+            profile: z.enum(ALL_PROFILES),
+            mode: z.enum(['plan', 'execute']).optional(),
+            allowGeneratedData: z.boolean().optional().describe('Permit generated disposable test data (required for account_cycle).'),
+            allowTestAccountDeletion: z.boolean().optional().describe('Permit deleting disposable test accounts (never a real account).'),
             offlineMode: z.boolean().optional().describe('Hint that resilience checks should drive offline state.'),
             sourceRevision: z
                 .object({ commit: z.string().optional(), buildVersion: z.string().optional(), branch: z.string().optional() })
                 .optional(),
             targetApp: z.string().optional(),
-            waitForCompletion: z
-                .boolean()
-                .optional()
-                .describe('Reserved; execute currently always runs to completion and returns the full result.'),
+            consentId: z.string().optional().describe('execute: consent for the resilience airplane-mode toggle (network_change).'),
+            approve: z.boolean().optional(),
         },
-    }, async ({ projectRoot, sessionId, profile, mode, allowGeneratedData, allowTestAccountDeletion, offlineMode, sourceRevision, targetApp, }) => {
-        const { root, hint } = await rootFor(server, sessions, { projectRoot, sessionId });
+    }, async ({ projectRoot, sessionId, profile, mode, allowGeneratedData, allowTestAccountDeletion, offlineMode, sourceRevision, targetApp, consentId, approve, }) => {
+        const { root, hint, error } = await rootFor(server, sessions, { projectRoot, sessionId });
         if (!root)
-            return qaError({
-                what: 'Could not resolve a project root',
-                changedState: false,
-                retrySafe: true,
-                nextSteps: ['Pass projectRoot or sessionId.'],
-                clientHint: hint,
-            });
+            return error ?? unresolvedProjectRootError({ source: 'none', hint });
         const prof = profile;
         const policyForRev = loadPolicy(root);
         const revisionResolved = resolveSourceRevision({
@@ -90,16 +76,36 @@ export function registerMobileAudit(server, sessions) {
                     retrySafe: true,
                     nextSteps: ['Call qa_start_session + qa_prepare_target (or qa_test_this), then qa_mobile_audit { mode:"execute" }.'],
                 });
-            const { driver } = await getDriver(session);
+            const { driver, blocked } = await getDriver(session);
             if (!driver)
-                return qaError({
-                    what: 'No device attached to this session',
-                    changedState: false,
-                    retrySafe: true,
-                    nextSteps: ['Prepare a device first (qa_test_this / qa_prepare_target), then re-run.'],
-                });
+                return (blockedDeviceResult(blocked) ??
+                    qaError({
+                        what: 'No device attached to this session',
+                        changedState: false,
+                        retrySafe: true,
+                        nextSteps: ['Prepare a device first (qa_test_this / qa_prepare_target), then re-run.'],
+                    }));
+            // resilience / release_gate toggle airplane mode: same network_change gate as qa_network.
+            let networkChangeApproved = false;
+            if (auditChangesNetwork(prof)) {
+                const req = auditNetworkConsentRequest(prof);
+                const gate = consumeConsent(consentId, approve, { action: req.action, affects: req.affects });
+                if (!gate.approved) {
+                    sessions.recordMutation(session, {
+                        tool: 'qa_mobile_audit',
+                        action: req.action,
+                        risk: req.risk,
+                        target: req.affects,
+                        consent: { required: true, approved: false },
+                        status: 'requested',
+                    });
+                    return requireConsent(req);
+                }
+                networkChangeApproved = true;
+            }
             try {
                 const run = await runMobileAudit(sessions, session, driver, {
+                    networkChangeApproved,
                     profile: prof,
                     allowGeneratedData,
                     allowTestAccountDeletion,
@@ -117,7 +123,7 @@ export function registerMobileAudit(server, sessions) {
                     /* report is best-effort */
                 }
                 const passed = run.checks.filter((c) => c.status === 'pass').length;
-                return qaOk({ ...run, markdown: auditRunToMarkdown(run), resourceUri: issuesResourceUri(root) }, `🔍 mobile audit ${prof}: ${run.state}, release=${run.releaseImpact} — ${passed}/${run.checks.length} pass, ${run.issueIds.length} issue(s)${run.recurrenceWarnings.length ? `, ${run.recurrenceWarnings.length} recurrence` : ''}`);
+                return qaOk({ ...run, markdown: auditRunToMarkdown(run) }, `🔍 mobile audit ${prof}: ${run.state}, release=${run.releaseImpact}, ${passed}/${run.checks.length} pass, ${run.issueIds.length} issue(s)${run.recurrenceWarnings.length ? `, ${run.recurrenceWarnings.length} recurrence` : ''}`);
             }
             catch (e) {
                 return qaError({
@@ -160,7 +166,6 @@ export function registerMobileAudit(server, sessions) {
             blockedChecks,
             recurrenceWarnings: recurrence,
             sourceRevision: revisionResolved,
-            resourceUri: issuesResourceUri(root),
         }, summary);
     });
 }

package/dist/tools/mobileAudit.js.map

@@ -1 +1 @@
-{"version":3,"file":"mobileAudit.js","sourceRoot":"","sources":["../../src/tools/mobileAudit.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mobileAudit.js","sourceRoot":"","sources":["../../src/tools/mobileAudit.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,qGAAqG;AACrG,sGAAsG;AACtG,sGAAsG;AACtG,2CAA2C;AAE3C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAC3F,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtE,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,YAAY,EAAqB,MAAM,4BAA4B,CAAC;AACnH,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC3G,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,SAAS,MAAM;IACb,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,KAAK,UAAU,OAAO,CACpB,MAAiB,EACjB,QAAsB,EACtB,IAAkD;IAElD,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACvC,IAAI,CAAC,CAAC;YAAE,OAAO,EAAE,KAAK,EAAE,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9D,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1B,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACpE,IAAI,CAAC,QAAQ,CAAC,IAAI;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnD,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,QAAsB;IAC3E,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,yBAAyB;QAChC,WAAW,EACT,iHAAiH;YACjH,oHAAoH;YACpH,mKAAmK;YACnK,uHAAuH;YACvH,kHAAkH;YAClH,WAAW;QACb,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAClC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAChC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,YAAqC,CAAC;YACtD,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE;YAC5C,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qEAAqE,CAAC;YAC1H,wBAAwB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kEAAkE,CAAC;YAC7H,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;YACvG,cAAc,EAAE,CAAC;iBACd,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC;iBAC7G,QAAQ,EAAE;YACb,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4EAA4E,CAAC;YACvH,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;SAChC;KACF,EACD,KAAK,EAAE,EACL,WAAW,EACX,SAAS,EACT,OAAO,EACP,IAAI,EACJ,kBAAkB,EAClB,wBAAwB,EACxB,WAAW,EACX,cAAc,EACd,SAAS,EACT,SAAS,EACT,OAAO,GACR,EAAE,EAAE;QACH,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC;QAC1F,IAAI,CAAC,IAAI;YAAE,OAAO,KAAK,IAAI,0BAA0B,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAEhF,MAAM,IAAI,GAAG,OAAuB,CAAC;QACrC,MAAM,YAAY,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,gBAAgB,GAAG,qBAAqB,CAAC;YAC7C,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS;YAClF,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,oBAAoB,EAAE,YAAY,CAAC,oBAAoB;YACvD,IAAI;SACL,CAAC,CAAC;QAEH,iEAAiE;QACjE,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAChE,IAAI,CAAC,OAAO;gBACV,OAAO,OAAO,CAAC;oBACb,IAAI,EAAE,uDAAuD;oBAC7D,YAAY,EAAE,KAAK;oBACnB,SAAS,EAAE,IAAI;oBACf,SAAS,EAAE,CAAC,uGAAuG,CAAC;iBACrH,CAAC,CAAC;YACL,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;YACrD,IAAI,CAAC,MAAM;gBACT,OAAO,CACL,mBAAmB,CAAC,OAAO,CAAC;oBAC5B,OAAO,CAAC;wBACN,IAAI,EAAE,oCAAoC;wBAC1C,YAAY,EAAE,KAAK;wBACnB,SAAS,EAAE,IAAI;wBACf,SAAS,EAAE,CAAC,yEAAyE,CAAC;qBACvF,CAAC,CACH,CAAC;YACJ,0FAA0F;YAC1F,IAAI,qBAAqB,GAAG,KAAK,CAAC;YAClC,IAAI,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9B,MAAM,GAAG,GAAG,0BAA0B,CAAC,IAAI,CAAC,CAAC;gBAC7C,MAAM,IAAI,GAAG,cAAc,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC9F,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACnB,QAAQ,CAAC,cAAc,CAAC,OAAO,EAAE;wBAC/B,IAAI,EAAE,iBAAiB;wBACvB,MAAM,EAAE,GAAG,CAAC,MAAM;wBAClB,IAAI,EAAE,GAAG,CAAC,IAAI;wBACd,MAAM,EAAE,GAAG,CAAC,OAAO;wBACnB,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE;wBAC5C,MAAM,EAAE,WAAW;qBACpB,CAAC,CAAC;oBACH,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC;gBAC7B,CAAC;gBACD,qBAAqB,GAAG,IAAI,CAAC;YAC/B,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE;oBAC1D,qBAAqB;oBACrB,OAAO,EAAE,IAAI;oBACb,kBAAkB;oBAClB,wBAAwB;oBACxB,WAAW;oBACX,cAAc,EAAE,gBAAgB;oBAChC,GAAG,EAAE,MAAM,EAAE;iBACd,CAAC,CAAC;gBACH,IAAI,SAA6B,CAAC;gBAClC,IAAI,CAAC;oBACH,MAAM,CAAC,GAAG,MAAM,qBAAqB,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;oBAC7D,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC;oBACxB,GAAG,CAAC,SAAS,GAAG,SAAS,CAAC;gBAC5B,CAAC;gBAAC,MAAM,CAAC;oBACP,2BAA2B;gBAC7B,CAAC;gBACD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC;gBACpE,OAAO,IAAI,CACT,EAAE,GAAG,GAAG,EAAE,QAAQ,EAAE,kBAAkB,CAAC,GAAG,CAAC,EAAE,EAC7C,mBAAmB,IAAI,KAAK,GAAG,CAAC,KAAK,aAAa,GAAG,CAAC,aAAa,KAAK,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,QAAQ,CAAC,MAAM,YAAY,GAAG,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,kBAAkB,CAAC,MAAM,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,CACnO,CAAC;YACJ,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,OAAO,CAAC;oBACb,IAAI,EAAE,wBAAwB,MAAM,CAAE,CAAW,CAAC,OAAO,IAAI,CAAC,CAAC,EAAE;oBACjE,YAAY,EAAE,IAAI;oBAClB,SAAS,EAAE,IAAI;oBACf,SAAS,EAAE,CAAC,kDAAkD,CAAC;iBAChE,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,2BAA2B;QAC3B,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,EAAE,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,WAAW,EAAE,CAAC,CAAC;QAEvG,gGAAgG;QAChG,gGAAgG;QAChG,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY;YAClC,CAAC,CAAC;gBACE,IAAI,EAAE,YAAY;gBAClB,IAAI,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,kBAAkB,EAAE,kBAAkB,KAAK,IAAI,EAAE;gBAC7E,IAAI,EAAE,kHAAkH;aACzH;YACH,CAAC,CAAC,SAAS,CAAC;QAEd,+FAA+F;QAC/F,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,qBAAqB,IAAI,CAAC,kBAAkB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAE5G,sEAAsE;QACtE,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC,CAAC;QACzE,MAAM,UAAU,GAAG,MAAM,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACzD,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,OAAO,EAAE,CAAC,CAAC,qBAAqB;SACjC,CAAC,CAAC,CAAC;QAEJ,MAAM,OAAO,GAAG,iBAAiB,IAAI,KAAK,MAAM,CAAC,MAAM,YAAY,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,aAAa,CAAC,MAAM,0BAA0B,CAAC,CAAC,CAAC,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,MAAM,wBAAwB,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC/N,OAAO,IAAI,CACT;YACE,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,IAAI;YACb,SAAS;YACT,MAAM;YACN,kBAAkB,EAAE,MAAM;YAC1B,QAAQ;YACR,aAAa;YACb,kBAAkB,EAAE,UAAU;YAC9B,cAAc,EAAE,gBAAgB;SACjC,EACD,OAAO,CACR,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/network.js

@@ -1,10 +1,10 @@
-// qa_network — safe offline/online testing without raw adb (Phase 2 CR2).
+// qa_network: safe offline/online testing without raw adb (Phase 2 CR2).
 // Uses `cmd connectivity airplane-mode` (API 30+). Records the original state on first
 // change so it can be restored; report + session-end restore use session.network.
 import { z } from 'zod';
-import { qaOk, qaError } from '../lib/result.js';
+import { qaOk, qaError, unknownSessionError } from '../lib/result.js';
 import { requireConsent, consumeConsent } from '../consent/consent.js';
-import { getDriver } from '../session/attach.js';
+import { blockedDeviceResult, getDriver } from '../session/attach.js';
 /** Restore network to the recorded original state. Exported for report/session-end use. */
 export async function restoreNetwork(sessions, session, d) {
     if (!session.network?.changed)
@@ -25,7 +25,7 @@ export async function restoreNetwork(sessions, session, d) {
     sessions.persist(session);
     return `restored (airplane=${original})`;
 }
-/** Best-effort restore of EVERY session that changed the network — for server shutdown. */
+/** Best-effort restore of EVERY session that changed the network, for server shutdown. */
 export async function restoreAllNetwork(sessions) {
     const { DirectDriver } = await import('../drivers/DirectDriver.js');
     for (const s of sessions.list()) {
@@ -56,7 +56,8 @@ export async function restoreAllNetwork(sessions) {
 export function registerNetwork(server, sessions) {
     server.registerTool('qa_network', {
         title: 'Network state control',
-        description: 'Offline/online testing via airplane mode (no raw adb; needs Android 11+ `cmd connectivity`). Actions: status, offline, online, restore. Swipium records the original airplane state on the first change and restores it on qa_report, on explicit `restore`, and best-effort on server shutdown (SIGINT/SIGTERM/transport close). offline/online require consent.',
+        description: 'Offline/online testing via airplane mode (Android 11+). action: status, offline/online (consent-gated), restore. The ' +
+            'original state is restored on qa_report, on restore, and on server shutdown.',
         inputSchema: {
             sessionId: z.string(),
             action: z.enum(['status', 'offline', 'online', 'restore']),
@@ -65,9 +66,23 @@ export function registerNetwork(server, sessions) {
         },
     }, async ({ sessionId, action, consentId, approve }) => {
         const session = sessions.get(sessionId);
-        const { driver: d } = session ? await getDriver(session) : { driver: undefined };
+        if (!session)
+            return unknownSessionError(sessionId);
+        const { driver: d, blocked } = await getDriver(session);
         if (!session || !d) {
-            return qaError({ what: 'No device attached', changedState: false, retrySafe: true, nextSteps: ['Call qa_prepare_target first.'] });
+            return (blockedDeviceResult(blocked) ??
+                qaError({ what: 'No device attached', changedState: false, retrySafe: true, nextSteps: ['Call qa_prepare_target first.'] }));
+        }
+        // Airplane-mode control is an Android emulator feature (`cmd connectivity airplane-mode`); iOS
+        // simulators have no equivalent, so answer with a typed refusal instead of a raw driver error.
+        if (d.kind !== 'direct') {
+            return qaError({
+                what: 'qa_network is supported on Android emulators only (iOS simulators have no airplane-mode control)',
+                changedState: false,
+                retrySafe: false,
+                failureCode: 'BACKEND_UNSUPPORTED',
+                nextSteps: ['On iOS, test offline behavior by disconnecting the Mac from the network or with a network link conditioner.'],
+            });
         }
         const airplane = await d.airplaneOn();
         if (action === 'status') {
@@ -76,13 +91,13 @@ export function registerNetwork(server, sessions) {
                 airplaneOn: airplane,
                 changedBySwipium: !!session.network?.changed,
                 restoreAvailable: !!session.network?.changed,
-            }, `network=${airplane ? 'offline (airplane on)' : 'online'}${session.network?.changed ? ' (changed by Swipium — will restore)' : ''}`);
+            }, `network=${airplane ? 'offline (airplane on)' : 'online'}${session.network?.changed ? ' (changed by Swipium, will restore)' : ''}`);
         }
         if (action === 'restore') {
             const msg = await restoreNetwork(sessions, session, d);
             return qaOk({ network: (await d.airplaneOn()) ? 'offline' : 'online', restored: !!msg }, msg ? `network ${msg}` : 'nothing to restore (Swipium did not change the network)');
         }
-        // offline / online — consent-gated, records original on first change.
+        // offline / online: consent-gated, records original on first change.
         const wantAirplane = action === 'offline';
         const gate = consumeConsent(consentId, approve, { action: 'network_change', affects: { to: action } });
         if (!gate.approved) {
@@ -110,7 +125,8 @@ export function registerNetwork(server, sessions) {
             consent: { required: true, consentId, approved: true, payloadHash: action },
             status: 'approved',
         });
-        if (!session.network?.changed) {
+        const firstChange = !session.network?.changed;
+        if (firstChange) {
             session.network = { changed: true, originalAirplane: airplane };
         }
         sessions.persist(session);
@@ -118,8 +134,9 @@ export function registerNetwork(server, sessions) {
             await d.setAirplane(wantAirplane);
         }
         catch (e) {
-            // Older images / no `cmd connectivity airplane-mode` (pre-Android 11).
-            if (!session.network.changed)
+            // Older images / no `cmd connectivity airplane-mode` (pre-Android 11). Nothing changed, so
+            // drop the restore record this call just created (an earlier change's record is kept).
+            if (firstChange)
                 session.network = undefined;
             sessions.persist(session);
             return qaError({
@@ -129,7 +146,7 @@ export function registerNetwork(server, sessions) {
                 nextSteps: ['Needs Android 11+ (`cmd connectivity airplane-mode`). Use a newer emulator image, or toggle network manually.'],
             });
         }
-        sessions.addEnvChange(session, `network → ${action} (airplane=${wantAirplane})`);
+        sessions.addEnvChange(session, `network > ${action} (airplane=${wantAirplane})`);
         await new Promise((r) => setTimeout(r, 1200)); // settle
         const now = await d.airplaneOn();
         sessions.recordMutation(session, {
@@ -141,7 +158,7 @@ export function registerNetwork(server, sessions) {
             status: 'executed',
             detail: `network=${now ? 'offline' : 'online'}`,
         });
-        return qaOk({ network: now ? 'offline' : 'online', previousStateRecorded: true, restoreAvailable: true }, `network → ${now ? 'offline' : 'online'}. Original recorded; restore on qa_report / qa_network restore.`);
+        return qaOk({ network: now ? 'offline' : 'online', previousStateRecorded: true, restoreAvailable: true }, `network > ${now ? 'offline' : 'online'}. Original recorded; restore on qa_report / qa_network restore.`);
     });
 }
 //# sourceMappingURL=network.js.map