agent-scenario-loop 0.1.1 → 0.1.3

package/dist/runner/live-proof.d.ts

@@ -17,6 +17,7 @@ type LiveProofArtifact = {
         skipped: number;
         unchanged: number;
         worse: number;
+        low_confidence: number;
     };
     comparisonStatus: string;
     comparisons: LiveProofComparisonPointer[];
@@ -82,7 +83,7 @@ type LiveProofArtifact = {
     summary: string;
 };
 type LiveProofComparisonCounts = LiveProofArtifact['comparisonCounts'];
-type LiveProofMetricStatus = 'better' | 'worse' | 'unchanged' | 'inconclusive';
+type LiveProofMetricStatus = 'better' | 'worse' | 'unchanged' | 'inconclusive' | 'low_confidence';
 type LiveProofPlatform = LiveProofArtifact['platform'];
 type LiveProofComparisonPointer = {
     baselineDir?: string | null;
@@ -102,7 +103,7 @@ type LiveProofComparisonPointer = {
     status?: string;
     summaryPath?: string | null;
 };
-type LiveProofAggregateStatus = ('baseline_missing' | 'improved' | 'inconclusive' | 'mixed' | 'not_compared' | 'regressed' | 'unchanged');
+type LiveProofAggregateStatus = ('baseline_missing' | 'improved' | 'inconclusive' | 'low_confidence' | 'mixed' | 'not_compared' | 'regressed' | 'unchanged');
 type LiveProofNextActionCode = LiveProofArtifact['nextAction']['code'];
 type LiveProofSetArtifact = {
     failureReasons: string[];

package/dist/runner/live-proof.js

@@ -153,6 +153,7 @@ function countLiveProofComparisons(comparisons) {
     const counts = {
         better: 0,
         inconclusive: 0,
+        low_confidence: 0,
         mixed: 0,
         skipped: 0,
         unchanged: 0,
@@ -183,6 +184,9 @@ function deriveLiveProofComparisonStatus(comparisons) {
     if (statuses.includes('inconclusive')) {
         return 'inconclusive';
     }
+    if (statuses.includes('low_confidence')) {
+        return 'low_confidence';
+    }
     if (statuses.every((status) => status === 'skipped')) {
         return 'baseline_missing';
     }
@@ -217,6 +221,9 @@ function expectedLiveProofNextActionCode(comparisonStatus, status = 'passed') {
     if (comparisonStatus === 'inconclusive') {
         return 'inspect_inconclusive';
     }
+    if (comparisonStatus === 'low_confidence') {
+        return 'inspect_low_confidence';
+    }
     if (comparisonStatus === 'mixed') {
         return 'inspect_mixed';
     }
@@ -439,7 +446,7 @@ function formatComparisonPointerMetrics(comparison) {
     const highlightText = highlights.length > 0
         ? `; notable: ${highlights.map(formatMetricHighlight).join(', ')}`
         : '';
-    return ` (metrics better=${counts.better} worse=${counts.worse} unchanged=${counts.unchanged} inconclusive=${counts.inconclusive}${highlightText})`;
+    return ` (metrics better=${counts.better} worse=${counts.worse} unchanged=${counts.unchanged} inconclusive=${counts.inconclusive} low_confidence=${counts.low_confidence}${highlightText})`;
 }
 /**
  * Formats capture counts for one interaction proof pointer.
@@ -815,7 +822,7 @@ function formatLiveProof(proof) {
         `Skipped interaction proofs: ${proof.skippedInteractionProofs?.length ?? 0}`,
         ...(proof.skippedInteractionProofs ?? []).map((proofPointer) => (`- ${proofPointer.label} (${proofPointer.runnerId}/${proofPointer.scenarioId}/${proofPointer.runId}): ${proofPointer.reason} next=${proofPointer.nextAction.code}`)),
         `Comparisons: ${proof.comparisons.length}`,
-        `Comparison counts: better=${proof.comparisonCounts.better} worse=${proof.comparisonCounts.worse} unchanged=${proof.comparisonCounts.unchanged} mixed=${proof.comparisonCounts.mixed} inconclusive=${proof.comparisonCounts.inconclusive} skipped=${proof.comparisonCounts.skipped}`,
+        `Comparison counts: better=${proof.comparisonCounts.better} worse=${proof.comparisonCounts.worse} unchanged=${proof.comparisonCounts.unchanged} mixed=${proof.comparisonCounts.mixed} inconclusive=${proof.comparisonCounts.inconclusive} low_confidence=${proof.comparisonCounts.low_confidence} skipped=${proof.comparisonCounts.skipped}`,
         ...proof.comparisons.map((comparison) => (`- ${comparison.label ?? 'comparison'} (${comparison.scenarioId ?? 'unknown-scenario'}/${comparison.runId ?? 'unknown-run'}): ${comparison.status ?? 'unknown'}${formatComparisonPointerMetrics(comparison)}`)),
         `Next action: ${proof.nextAction.code} - ${proof.nextAction.summary}`,
         `Summary: ${proof.summary}`,

package/dist/runner/profile-android.d.ts

@@ -8,8 +8,13 @@ type AndroidProfileOptions = {
 };
 type AndroidAdbProfileCommand = {
     command: string;
+    commandId?: string;
     label?: string;
+    queueId?: string;
+    sequence?: number;
+    waitForMilestone?: string;
     waitMs?: number;
+    waitTimeoutMs?: number;
 };
 type AndroidAdbDriverStep = import('./android-adb').AndroidAdbDriverStep;
 /**

package/dist/runner/profile-android.js

@@ -26,6 +26,21 @@ const PROFILE_SESSION_CAPTURE_BOOTSTRAP_MS = 1000;
 const PROFILE_SESSION_CAPTURE_MAX_MS = 120000;
 const DEFAULT_ANDROID_PROFILE_SESSION_STORAGE_KEY = 'agent-scenario-loop.profile-session.1';
 const DEFAULT_ANDROID_PROFILE_COMMAND_STORAGE_KEY = 'agent-scenario-loop.profile-commands.1';
+const MANIFEST_LIFECYCLE_PHASES = new Set([
+    'cold-launch',
+    'warm-launch',
+    'hot-launch',
+    'resume',
+    'foreground',
+    'background',
+    'force-stop',
+    'process-death',
+    'scene-recreation',
+    'activity-recreation',
+    'os-reclaim',
+    'reboot',
+    'relaunch',
+]);
 /**
  * Reads and parses a JSON object from disk.
  *
@@ -54,6 +69,22 @@ function isEnabled(value) {
 function readPositiveInteger(value, fallback) {
     return typeof value === 'number' && Number.isInteger(value) && value > 0 ? value : fallback;
 }
+/**
+ * Resolves the lifecycle phase this runner is prepared to assert.
+ *
+ * @param {import('./profile-mobile').CliArgs} args
+ * @returns {string}
+ */
+function resolveManifestLifecyclePhase(args) {
+    const lifecyclePhase = readScalarArg(args['lifecycle-phase']);
+    if (lifecyclePhase === undefined) {
+        return 'cold-launch';
+    }
+    if (typeof lifecyclePhase !== 'string' || !MANIFEST_LIFECYCLE_PHASES.has(lifecyclePhase)) {
+        throw new Error(`Unsupported --lifecycle-phase "${String(lifecyclePhase)}". Expected one of ${Array.from(MANIFEST_LIFECYCLE_PHASES).join(', ')}.`);
+    }
+    return lifecyclePhase;
+}
 /**
  * Reads the number of scenario iterations that can emit app-owned truth events.
  *
@@ -119,7 +150,7 @@ function resolveAndroidPackageName({ args, config, }) {
  * @param {{config: Record<string, unknown>, action: 'start' | 'command', scenario: string, runId: string, command?: string}} options
  * @returns {string}
  */
-function buildProfileSessionUrl({ action, command, config, runId, scenario, }) {
+function buildProfileSessionUrl({ action, command, commandId, config, queueId, runId, scenario, sequence, waitForMilestone, waitTimeoutMs, }) {
     const scheme = typeof config.app?.profileSessionScheme === 'string'
         ? config.app.profileSessionScheme
         : typeof config.app?.scheme === 'string'
@@ -128,6 +159,21 @@ function buildProfileSessionUrl({ action, command, config, runId, scenario, }) {
     const params = new URLSearchParams({ runId, scenario });
     if (action === 'command' && command) {
         params.set('command', command);
+        if (commandId) {
+            params.set('commandId', commandId);
+        }
+        if (typeof sequence === 'number') {
+            params.set('sequence', String(sequence));
+        }
+        if (queueId) {
+            params.set('queueId', queueId);
+        }
+        if (waitForMilestone) {
+            params.set('waitForMilestone', waitForMilestone);
+        }
+        if (typeof waitTimeoutMs === 'number') {
+            params.set('waitTimeoutMs', String(waitTimeoutMs));
+        }
     }
     return `${scheme}://profile-session/${action}?${params.toString()}`;
 }
@@ -138,6 +184,23 @@ function buildProfileSessionUrl({ action, command, config, runId, scenario, }) {
  * @returns {import('./android-adb').AndroidAsyncStorageWrite[]}
  */
 function buildProfileSessionStorageWrites({ commands, commandStorageKey, commandWaitMs, runId, scenario, sessionStorageKey, }) {
+    const timestampBase = Date.now();
+    const storedCommands = commands.map((profileCommand, index) => {
+        const timestamp = timestampBase + index + 1;
+        return {
+            id: `${timestamp}-${scenario}-${profileCommand.command}`,
+            scenario,
+            runId,
+            command: profileCommand.command,
+            ...(typeof profileCommand.commandId === 'string' ? { commandId: profileCommand.commandId } : {}),
+            ...(typeof profileCommand.sequence === 'number' ? { sequence: profileCommand.sequence } : {}),
+            ...(typeof profileCommand.queueId === 'string' ? { queueId: profileCommand.queueId } : {}),
+            ...(typeof profileCommand.waitForMilestone === 'string' ? { waitForMilestone: profileCommand.waitForMilestone } : {}),
+            ...(typeof profileCommand.waitTimeoutMs === 'number' ? { waitTimeoutMs: profileCommand.waitTimeoutMs } : {}),
+            timestamp,
+        };
+    });
+    const commandWaitMsTotal = commands.reduce((total, profileCommand) => (total + (typeof profileCommand.waitMs === 'number' && profileCommand.waitMs > 0 ? profileCommand.waitMs : 0)), 0);
     return [
         {
             clearKeys: [commandStorageKey],
@@ -151,21 +214,14 @@ function buildProfileSessionStorageWrites({ commands, commandStorageKey, command
             }).replace(`"${ANDROID_DEVICE_EPOCH_MS_PLACEHOLDER}"`, ANDROID_DEVICE_EPOCH_MS_PLACEHOLDER),
             waitMs: commandWaitMs,
         },
-        ...commands.map((profileCommand, index) => {
-            const timestamp = Date.now() + index + 1;
-            return {
-                key: commandStorageKey,
-                label: profileCommand.label ?? `profile-command-${index + 1}`,
-                value: JSON.stringify([{
-                        id: `${timestamp}-${scenario}-${profileCommand.command}`,
-                        scenario,
-                        runId,
-                        command: profileCommand.command,
-                        timestamp,
-                    }]),
-                ...(typeof profileCommand.waitMs === 'number' ? { waitMs: profileCommand.waitMs } : {}),
-            };
-        }),
+        ...(storedCommands.length > 0
+            ? [{
+                    key: commandStorageKey,
+                    label: 'profile-command-queue',
+                    value: JSON.stringify(storedCommands),
+                    ...(commandWaitMsTotal > 0 ? { waitMs: commandWaitMsTotal } : {}),
+                }]
+            : []),
     ];
 }
 /**
@@ -271,14 +327,30 @@ function appendCaptureArg({ args, value, }) {
 function resolveExecutionPlanProfileCommands(scenario) {
     const executionPlan = buildScenarioExecutionPlan(scenario);
     const repeat = readPositiveInteger(scenario.defaultIterations, readPositiveInteger(scenario.cycles?.iterations, 1));
-    const commands = executionPlan.steps
-        .filter((step) => step.portMethod === 'executeStep' && typeof step.command === 'string')
-        .map((step) => ({
-        command: step.command,
-        label: step.id,
-        waitMs: readStepWaitMs(step),
-    }));
-    return Array.from({ length: repeat }).flatMap(() => commands);
+    const commands = [];
+    for (const [index, step] of executionPlan.steps.entries()) {
+        if (step.portMethod !== 'executeStep' || typeof step.command !== 'string') {
+            continue;
+        }
+        const nextStep = executionPlan.steps[index + 1];
+        commands.push({
+            command: step.command,
+            commandId: step.id,
+            label: step.id,
+            queueId: scenario.id ?? scenario.name,
+            waitMs: readStepWaitMs(step),
+            ...(nextStep?.portMethod === 'waitForTruthEvent' && typeof nextStep.milestone === 'string'
+                ? {
+                    waitForMilestone: nextStep.milestone,
+                    waitTimeoutMs: readPositiveInteger(nextStep.timeoutMs, 0),
+                }
+                : {}),
+        });
+    }
+    return Array.from({ length: repeat }).flatMap((_, iteration) => commands.map((command, commandIndex) => ({
+        ...command,
+        sequence: (iteration * commands.length) + commandIndex + 1,
+    })));
 }
 /**
  * Expands normalized scenario evidence steps into Android adb driver actions.
@@ -392,7 +464,16 @@ function resolveAndroidAdbProfileCommands(scenario) {
             }
             commands.push({
                 command: command.command,
+                commandId: typeof command.id === 'string'
+                    ? command.id
+                    : typeof command.commandId === 'string'
+                        ? command.commandId
+                        : typeof command.label === 'string'
+                            ? command.label
+                            : command.command,
                 ...(typeof command.label === 'string' ? { label: command.label } : {}),
+                queueId: scenario.id ?? scenario.name,
+                sequence: commands.length + 1,
                 waitMs: readPositiveInteger(command.waitMs, 0),
             });
         }
@@ -459,6 +540,7 @@ function appendAgentDeviceCaptureArgs({ args, capture, }) {
 async function runProfileAndroid(args, options = {}) {
     if (!isEnabled(args['adb-capture']) && !isEnabled(args['agent-device-capture'])) {
         return runProfileMobile(args, {
+            commandTransport: typeof args.events === 'string' ? 'fixture-log-ingest' : 'adb-artifacts',
             ...(options.comparisonLane ? { comparisonLane: options.comparisonLane } : {}),
             defaultDriver: 'adb-logcat',
             ...(typeof args['adb-artifacts'] === 'string' ? { interactionDriver: 'adb-logcat' } : {}),
@@ -530,9 +612,14 @@ async function runProfileAndroid(args, options = {}) {
                 url: buildProfileSessionUrl({
                     action: 'command',
                     command: profileCommand.command,
+                    ...(typeof profileCommand.commandId === 'string' ? { commandId: profileCommand.commandId } : {}),
                     config,
                     runId,
                     scenario: scenarioName,
+                    ...(typeof profileCommand.queueId === 'string' ? { queueId: profileCommand.queueId } : {}),
+                    ...(typeof profileCommand.sequence === 'number' ? { sequence: profileCommand.sequence } : {}),
+                    ...(typeof profileCommand.waitForMilestone === 'string' ? { waitForMilestone: profileCommand.waitForMilestone } : {}),
+                    ...(typeof profileCommand.waitTimeoutMs === 'number' ? { waitTimeoutMs: profileCommand.waitTimeoutMs } : {}),
                 }),
                 waitMs: profileCommand.waitMs,
             })),
@@ -635,9 +722,46 @@ async function runProfileAndroid(args, options = {}) {
     const profileArgs = agentDeviceCapture
         ? appendAgentDeviceCaptureArgs({ args: baseProfileArgs, capture: agentDeviceCapture })
         : baseProfileArgs;
+    const lifecyclePhase = resolveManifestLifecyclePhase(args);
+    const environmentSource = agentDeviceCapture ? 'agent-device' : 'adb';
+    const lifecycleArtifact = adbCapture ? 'raw/adb-logcat.txt' : 'raw/interaction.log';
     return runProfileMobile(profileArgs, {
+        commandTransport: profileSessionStorageEnabled
+            ? 'profile-session-storage'
+            : profileSessionEnabled
+                ? 'profile-session-deeplink'
+                : agentDeviceCapture
+                    ? 'agent-device'
+                    : 'adb-capture',
         ...(options.comparisonLane ? { comparisonLane: options.comparisonLane } : {}),
         defaultDriver: 'adb-logcat',
+        environmentPostconditions: {
+            appState: {
+                value: 'foreground',
+                evidence: 'asserted',
+                source: environmentSource,
+                artifact: lifecycleArtifact,
+            },
+            lifecyclePhase: {
+                value: 'foreground',
+                evidence: 'asserted',
+                source: environmentSource,
+                artifact: lifecycleArtifact,
+            },
+        },
+        environmentPreconditions: {
+            foregroundState: {
+                value: 'controlled-by-runner',
+                evidence: 'asserted',
+                source: environmentSource,
+            },
+            lifecyclePhase: {
+                value: lifecyclePhase,
+                evidence: 'asserted',
+                source: environmentSource,
+                artifact: lifecycleArtifact,
+            },
+        },
         interactionDriver: agentDeviceCapture ? 'agent-device' : 'adb-logcat',
         platform: 'android',
     });

package/dist/runner/profile-ios.d.ts

@@ -8,8 +8,13 @@ type IosProfileOptions = {
 };
 type IosSimctlProfileCommand = {
     command: string;
+    commandId?: string;
     label?: string;
+    queueId?: string;
+    sequence?: number;
+    waitForMilestone?: string;
     waitMs?: number;
+    waitTimeoutMs?: number;
 };
 /**
  * Resolves the simctl capture output directory for a profile run.
@@ -44,12 +49,17 @@ declare function resolveIosConflictingBundleIds(config: Record<string, any>): st
  * @param {{config: Record<string, unknown>, action: 'start' | 'command', scenario: string, runId: string, command?: string}} options
  * @returns {string}
  */
-declare function buildProfileSessionUrl({ action, command, config, runId, scenario, }: {
+declare function buildProfileSessionUrl({ action, command, commandId, config, queueId, runId, scenario, sequence, waitForMilestone, waitTimeoutMs, }: {
     action: 'start' | 'command';
     command?: string;
+    commandId?: string;
     config: Record<string, any>;
+    queueId?: string;
     runId: string;
     scenario: string;
+    sequence?: number;
+    waitForMilestone?: string;
+    waitTimeoutMs?: number;
 }): string;
 /**
  * Derives a storage-backed profile capture window from scenario waits and cycles.

package/dist/runner/profile-ios.js

@@ -34,6 +34,21 @@ const DEFAULT_IOS_PROFILE_COMMAND_STORAGE_KEY = 'agent-scenario-loop.profile-com
 const DEFAULT_IOS_PROFILE_EVENT_STORAGE_KEY = 'agent-scenario-loop.profile-events.1';
 const DEFAULT_IOS_PROFILE_SIGNAL_STORAGE_KEY = 'agent-scenario-loop.profile-signals.1';
 const DEFAULT_IOS_PROFILE_SESSION_ENTRIES_STORAGE_KEY = 'agent-scenario-loop.profile-session-entries.1';
+const MANIFEST_LIFECYCLE_PHASES = new Set([
+    'cold-launch',
+    'warm-launch',
+    'hot-launch',
+    'resume',
+    'foreground',
+    'background',
+    'force-stop',
+    'process-death',
+    'scene-recreation',
+    'activity-recreation',
+    'os-reclaim',
+    'reboot',
+    'relaunch',
+]);
 /**
  * Reads and parses a JSON object from disk.
  *
@@ -63,6 +78,22 @@ function readPositiveInteger(value, fallback) {
     const parsed = typeof value === 'string' ? Number(value) : value;
     return typeof parsed === 'number' && Number.isInteger(parsed) && parsed > 0 ? parsed : fallback;
 }
+/**
+ * Resolves the lifecycle phase this runner is prepared to assert.
+ *
+ * @param {import('./profile-mobile').CliArgs} args
+ * @returns {string}
+ */
+function resolveManifestLifecyclePhase(args) {
+    const lifecyclePhase = readScalarArg(args['lifecycle-phase']);
+    if (lifecyclePhase === undefined) {
+        return 'cold-launch';
+    }
+    if (typeof lifecyclePhase !== 'string' || !MANIFEST_LIFECYCLE_PHASES.has(lifecyclePhase)) {
+        throw new Error(`Unsupported --lifecycle-phase "${String(lifecyclePhase)}". Expected one of ${Array.from(MANIFEST_LIFECYCLE_PHASES).join(', ')}.`);
+    }
+    return lifecyclePhase;
+}
 /**
  * Reads the number of scenario iterations that can emit app-owned truth events.
  *
@@ -140,7 +171,7 @@ function resolveIosConflictingBundleIds(config) {
  * @param {{config: Record<string, unknown>, action: 'start' | 'command', scenario: string, runId: string, command?: string}} options
  * @returns {string}
  */
-function buildProfileSessionUrl({ action, command, config, runId, scenario, }) {
+function buildProfileSessionUrl({ action, command, commandId, config, queueId, runId, scenario, sequence, waitForMilestone, waitTimeoutMs, }) {
     const scheme = typeof config.app?.profileSessionScheme === 'string'
         ? config.app.profileSessionScheme
         : typeof config.app?.scheme === 'string'
@@ -149,6 +180,21 @@ function buildProfileSessionUrl({ action, command, config, runId, scenario, }) {
     const params = new URLSearchParams({ runId, scenario });
     if (action === 'command' && command) {
         params.set('command', command);
+        if (commandId) {
+            params.set('commandId', commandId);
+        }
+        if (typeof sequence === 'number') {
+            params.set('sequence', String(sequence));
+        }
+        if (queueId) {
+            params.set('queueId', queueId);
+        }
+        if (waitForMilestone) {
+            params.set('waitForMilestone', waitForMilestone);
+        }
+        if (typeof waitTimeoutMs === 'number') {
+            params.set('waitTimeoutMs', String(waitTimeoutMs));
+        }
     }
     return `${scheme}://profile-session/${action}?${params.toString()}`;
 }
@@ -211,14 +257,30 @@ function resolveProfileSessionCaptureWaitMs({ args, profileSessionEnabled, scena
 function resolveExecutionPlanProfileCommands(scenario) {
     const executionPlan = buildScenarioExecutionPlan(scenario);
     const repeat = readPositiveInteger(scenario.defaultIterations, readPositiveInteger(scenario.cycles?.iterations, 1));
-    const commands = executionPlan.steps
-        .filter((step) => step.portMethod === 'executeStep' && typeof step.command === 'string')
-        .map((step) => ({
-        command: step.command,
-        label: step.id,
-        waitMs: readStepWaitMs(step),
-    }));
-    return Array.from({ length: repeat }).flatMap(() => commands);
+    const commands = [];
+    for (const [index, step] of executionPlan.steps.entries()) {
+        if (step.portMethod !== 'executeStep' || typeof step.command !== 'string') {
+            continue;
+        }
+        const nextStep = executionPlan.steps[index + 1];
+        commands.push({
+            command: step.command,
+            commandId: step.id,
+            label: step.id,
+            queueId: scenario.id ?? scenario.name,
+            waitMs: readStepWaitMs(step),
+            ...(nextStep?.portMethod === 'waitForTruthEvent' && typeof nextStep.milestone === 'string'
+                ? {
+                    waitForMilestone: nextStep.milestone,
+                    waitTimeoutMs: readPositiveInteger(nextStep.timeoutMs, 0),
+                }
+                : {}),
+        });
+    }
+    return Array.from({ length: repeat }).flatMap((_, iteration) => commands.map((command, commandIndex) => ({
+        ...command,
+        sequence: (iteration * commands.length) + commandIndex + 1,
+    })));
 }
 /**
  * Expands scenario-declared iOS commands for a simctl capture profile session.
@@ -240,7 +302,16 @@ function resolveIosSimctlProfileCommands(scenario) {
             }
             commands.push({
                 command: command.command,
+                commandId: typeof command.id === 'string'
+                    ? command.id
+                    : typeof command.commandId === 'string'
+                        ? command.commandId
+                        : typeof command.label === 'string'
+                            ? command.label
+                            : command.command,
                 ...(typeof command.label === 'string' ? { label: command.label } : {}),
+                queueId: scenario.id ?? scenario.name,
+                sequence: commands.length + 1,
                 waitMs: readPositiveInteger(command.waitMs, 0),
             });
         }
@@ -327,6 +398,7 @@ function appendAgentDeviceCaptureArgs({ args, capture, }) {
 async function runProfileIos(args, options = {}) {
     if (!isEnabled(args['simctl-capture']) && !isEnabled(args['agent-device-capture'])) {
         return runProfileMobile(args, {
+            commandTransport: typeof args.events === 'string' ? 'fixture-log-ingest' : 'simctl-artifacts',
             ...(options.comparisonLane ? { comparisonLane: options.comparisonLane } : {}),
             defaultDriver: 'ios-simctl',
             ...(typeof args['simctl-artifacts'] === 'string' ? { interactionDriver: 'ios-simctl' } : {}),
@@ -397,9 +469,14 @@ async function runProfileIos(args, options = {}) {
                 url: buildProfileSessionUrl({
                     action: 'command',
                     command: profileCommand.command,
+                    ...(typeof profileCommand.commandId === 'string' ? { commandId: profileCommand.commandId } : {}),
                     config,
                     runId,
                     scenario: scenarioName,
+                    ...(typeof profileCommand.queueId === 'string' ? { queueId: profileCommand.queueId } : {}),
+                    ...(typeof profileCommand.sequence === 'number' ? { sequence: profileCommand.sequence } : {}),
+                    ...(typeof profileCommand.waitForMilestone === 'string' ? { waitForMilestone: profileCommand.waitForMilestone } : {}),
+                    ...(typeof profileCommand.waitTimeoutMs === 'number' ? { waitTimeoutMs: profileCommand.waitTimeoutMs } : {}),
                 }),
                 waitMs: profileCommand.waitMs,
             })),
@@ -431,8 +508,13 @@ async function runProfileIos(args, options = {}) {
                     profileSessionStorage: {
                         commands: profileSessionCommands.map((profileCommand, index) => ({
                             command: profileCommand.command,
+                            ...(typeof profileCommand.commandId === 'string' ? { commandId: profileCommand.commandId } : {}),
                             id: `ios-storage-command-${index + 1}`,
                             ...(typeof profileCommand.label === 'string' ? { label: profileCommand.label } : {}),
+                            ...(typeof profileCommand.queueId === 'string' ? { queueId: profileCommand.queueId } : {}),
+                            ...(typeof profileCommand.sequence === 'number' ? { sequence: profileCommand.sequence } : {}),
+                            ...(typeof profileCommand.waitForMilestone === 'string' ? { waitForMilestone: profileCommand.waitForMilestone } : {}),
+                            ...(typeof profileCommand.waitTimeoutMs === 'number' ? { waitTimeoutMs: profileCommand.waitTimeoutMs } : {}),
                         })),
                         runId,
                         scenario: scenarioName,
@@ -496,9 +578,46 @@ async function runProfileIos(args, options = {}) {
     const profileArgs = agentDeviceCapture
         ? appendAgentDeviceCaptureArgs({ args: baseProfileArgs, capture: agentDeviceCapture })
         : baseProfileArgs;
+    const lifecyclePhase = resolveManifestLifecyclePhase(args);
+    const environmentSource = agentDeviceCapture ? 'agent-device' : 'simctl';
+    const lifecycleArtifact = simctlCapture ? 'raw/ios-simctl-log.txt' : 'raw/interaction.log';
     return runProfileMobile(profileArgs, {
+        commandTransport: agentDeviceCapture
+            ? 'agent-device'
+            : profileSessionEnabled && !profileSessionStorageEnabled
+                ? 'profile-session-deeplink'
+                : profileSessionEnabled
+                    ? 'profile-session-storage'
+                    : 'simctl-capture',
         ...(options.comparisonLane ? { comparisonLane: options.comparisonLane } : {}),
         defaultDriver: 'ios-simctl',
+        environmentPostconditions: {
+            appState: {
+                value: 'foreground',
+                evidence: 'asserted',
+                source: environmentSource,
+                artifact: lifecycleArtifact,
+            },
+            lifecyclePhase: {
+                value: 'foreground',
+                evidence: 'asserted',
+                source: environmentSource,
+                artifact: lifecycleArtifact,
+            },
+        },
+        environmentPreconditions: {
+            foregroundState: {
+                value: 'controlled-by-runner',
+                evidence: 'asserted',
+                source: environmentSource,
+            },
+            lifecyclePhase: {
+                value: lifecyclePhase,
+                evidence: 'asserted',
+                source: environmentSource,
+                artifact: lifecycleArtifact,
+            },
+        },
         interactionDriver: agentDeviceCapture ? 'agent-device' : 'ios-simctl',
         platform: 'ios',
     });

package/dist/runner/profile-mobile.d.ts

@@ -21,10 +21,14 @@ type ProfileRunResult = {
 };
 type ProfilePlatform = 'android' | 'ios';
 type ProfileMobileOptions = {
+    commandTransport?: string;
     comparisonLane?: string;
     defaultDriver: string;
+    environmentPostconditions?: Record<string, unknown>;
+    environmentPreconditions?: Record<string, unknown>;
     interactionDriver?: string;
     platform: ProfilePlatform;
+    provenanceCohort?: Record<string, unknown>;
 };
 type CaptureEvidenceKind = 'screenshot' | 'uiTree' | 'video';
 type ProviderEvidenceKind = 'accessibility' | 'logs' | 'profiler';
@@ -33,13 +37,17 @@ type EvidenceChannel = 'capture' | 'provider' | 'signal';
 type EvidenceKind = CaptureEvidenceKind | ProviderEvidenceKind | SignalEvidenceKind;
 type EvidenceAttachment = {
     channel: EvidenceChannel;
+    completenessStatus: 'complete';
+    corruptionStatus: 'valid';
     destinationPath: string;
     kind: EvidenceKind;
     manifestPath: string;
+    redactionStatus: 'not-redacted';
     sha256: string;
     sourcePath: string;
     sourceFileName: string;
     sizeBytes: number;
+    transformations: readonly ['copied'];
 };
 type EvidenceAttachmentInput = {
     channel: EvidenceChannel;