@exodus/xqa 1.14.1 → 1.15.0

package/README.md

@@ -14,12 +14,20 @@ The tool manages configuration, project initialization, session state tracking,
 
 Initialize a new xqa project in the current directory.
 
-Creates a `.xqa/` directory with templates and subdirectories for specs, designs, and suites. Installs the `xqa-spec` skill for creating test specs.
+Creates a `.xqa/` directory with `app.md` and `explore.md` templates plus subdirectories for specs, designs, and suites. Installs bundled xqa skills.
 
 ```bash
 xqa init
 ```
 
+### update
+
+Update installed xqa skills to the current CLI version.
+
+```bash
+xqa update
+```
+
 ### explore [prompt]
 
 Run the explorer agent; omit prompt for a full breadth-first sweep.
@@ -31,44 +39,73 @@ xqa explore                          # breadth-first exploration
 xqa explore "test the login flow"    # focused exploration
 xqa explore -v prompt,screen         # verbose output for categories
 xqa explore -v                       # verbose output for all categories
+xqa explore -t 600                   # override explorer timeout (seconds)
+xqa explore --debug                  # log timing and event details to stderr
 ```
 
-Flag: `-v, --verbose [categories]` — Log categories (prompt, tools, screen, memory). Default: all if flag is present without value.
+Flags:
+
+- `-v, --verbose [categories]` — Log categories (prompt, tools, screen, memory). Default: all if flag is present without value.
+- `-t, --timeout <seconds>` — Explorer timeout in seconds (overrides `QA_EXPLORE_TIMEOUT_SECONDS`).
+- `--debug` — Log timing and event details to stderr.
 
 ### spec [spec-file]
 
 Run the explorer agent against a spec file.
 
-Loads a spec markdown file from `.xqa/specs/` (or an absolute path) and executes the agent against it. Spec files define entry points, steps, and optional timeouts. Omit the argument to pick from available specs interactively.
+Loads a spec markdown file from `.xqa/specs/` (or an absolute path) and executes the agent against it. Omit the argument to pick from available specs interactively.
 
 ```bash
 xqa spec                                      # interactive spec picker
-xqa spec .xqa/specs/authentication.test.md   # explicit spec file
+xqa spec .xqa/specs/authentication.test.md    # explicit spec file
 xqa spec -v tools,memory                      # verbose output
+xqa spec --debug                              # debug logging
 ```
 
-Flag: `-v, --verbose [categories]` — Same as explore.
+Flags:
+
+- `-v, --verbose [categories]` — Same as explore.
+- `--debug` — Log timing and event details to stderr.
 
 Spec file format (YAML frontmatter + markdown):
 
 ```markdown
 ---
 feature: 'Feature Name'
-entry: 'Screen name or navigation path'
 timeout: 300
 ---
 
 # Spec content
 ```
 
+Frontmatter fields: `feature` (required), `timeout` (optional, seconds).
+
+### run
+
+Run a test suite or a set of spec files in parallel across booted simulators.
+
+Exactly one of `--suite` or `--spec` is required.
+
+```bash
+xqa run --suite smoke                         # run .xqa/suites/smoke.suite.json
+xqa run --spec 'specs/**/*.test.md'           # run matching spec files
+xqa run --suite smoke --debug                 # debug logging
+```
+
+Flags:
+
+- `--suite <name>` — Name of the suite (`<name>.suite.json`) under `.xqa/suites/`.
+- `--spec <globs...>` — Glob patterns matching spec files, resolved from the xqa directory.
+- `--debug` — Log timing and event details to stderr.
+
 ### review [findings-path]
 
 Review findings and mark false positives.
 
-Interactive session for triaging findings generated by explore or spec runs. Displays findings with confidence scores, steps, and screenshots. Mark findings as false positives (with optional reason) or undo previous dismissals. Saves dismissals to `.xqa/dismissals.json`. Defaults to the last findings path if omitted.
+Interactive session for triaging findings generated by explore or spec runs. Mark findings as dismissed (with optional reason) or undo previous dismissals. Dismissals are written to `dismissals.json` next to the `.xqa` directory (override with `QA_DISMISSALS_PATH`). Defaults to the last findings path if omitted.
 
 ```bash
-xqa review                                      # use last findings file
+xqa review                                     # use last findings file
 xqa review .xqa/output/findings-abc123.json    # explicit path
 ```
 
@@ -93,26 +130,35 @@ xqa completion bash  # generate bash completions
 xqa completion zsh   # generate zsh completions
 ```
 
-### Suite hooks
+### Suite config
 
-Suite config files may declare a `beforeEach` hook that runs before every work item on every simulator. Use this for project-owned setup (wallet provisioning, cache warming, login seeding).
+Suite files live at `.xqa/suites/<name>.suite.json` and declare the work items plus optional hooks.
 
 ```json
 {
   "specs": ["specs/send.test.md"],
+  "freestyle": [{ "prompt": "explore settings", "timeoutSeconds": 300 }],
   "hooks": {
     "beforeEach": {
       "script": "qa/prepare-sim.mjs",
-      "env": { "APP_PROFILE": "funded" }
+      "env": { "APP_PROFILE": "funded" },
+      "timeoutSeconds": 120
     }
   }
 }
 ```
 
+Fields:
+
+- `specs` (optional) — glob patterns resolved from the xqa directory.
+- `freestyle` (optional) — either a positive integer (N empty entries) or an array of `{ prompt?, timeoutSeconds }` entries.
+- At least one of `specs` or `freestyle` must resolve to a work item.
+- `hooks.beforeEach` (optional) — runs before every work item on every simulator. Use for project-owned setup (wallet provisioning, cache warming, login seeding).
+
 The hook script is invoked as a Node child process. It receives:
 
 - Inherited `process.env`
-- Suite-declared `env` (merged below reserved keys)
+- Suite-declared `env` overlaid with reserved keys (reserved wins)
 - Reserved xqa-owned keys: `XQA_SIM_UDID`, `XQA_ITEM_ID`, `XQA_ITEM_TYPE`, `XQA_ITEM_NAME`, `XQA_SUITE`, and (when item type is `spec`) `XQA_SPEC_PATH`
 
 Suite-declared `env` cannot override reserved keys — the parser rejects such configs.
@@ -121,7 +167,7 @@ Contract:
 
 - Exit 0 → proceed with item.
 - Non-zero exit → item marked failed, `executeItem` skipped, counts toward simulator-unhealthy threshold.
-- 120s timeout (not configurable in v1).
+- Default 120s timeout, overridable via `hooks.beforeEach.timeoutSeconds`.
 - Honors the suite abort signal.
 
 ## Configuration
@@ -133,15 +179,17 @@ Configuration is loaded from environment variables and `.env.local`:
 - `QA_RUN_ID` (optional) — Custom run identifier; defaults to auto-generated
 - `QA_EXPLORE_TIMEOUT_SECONDS` (optional) — Exploration timeout in seconds
 - `QA_BUILD_ENV` (optional) — Build environment: `dev` or `prod` (default: prod)
+- `QA_DISMISSALS_PATH` (optional) — Override the dismissals file path used by `xqa review`
 
 ## Architecture
 
 Key files and directories:
 
 - `src/index.ts` — CLI entry point; wires commander commands and manages graceful shutdown via process locks
-- `src/commands/` — Command implementations (init, explore, spec, review, analyse, completion)
-- `src/core/` — Pure functions: spec parsing, completion generation, verbose option parsing, last-path tracking
-- `src/shell/` — I/O wrappers: file reading, device discovery, app context loading
+- `src/commands/` — Command implementations (init, update, explore, spec, review, analyse, completion)
+- `src/suite/` — Suite runner: config parsing, work-item building, worker pool, hooks
+- `src/core/` — Pure functions: completion generation, verbose/timeout option parsing, last-path tracking
+- `src/shell/` — I/O wrappers: app/explore context reading, debug logging, display factory, preflight, xqa directory discovery
 - `src/config.ts`, `src/config-schema.ts` — Configuration loading and validation with Zod
 - `src/review-session.ts` — Interactive finding review loop with dismissal tracking
 - `src/spec-frontmatter.ts` — Spec markdown frontmatter parsing (YAML)
@@ -157,6 +205,8 @@ Core error discriminated unions:
 - `XqaDirectoryError` — No .xqa directory found (XQA_NOT_INITIALIZED)
 - `SpecFrontmatterError` — Malformed spec markdown (MISSING_FRONTMATTER, MISSING_FIELD, PARSE_ERROR)
 - `LastPathError` — No findings path provided and no prior session (NO_ARG_AND_NO_STATE)
+- `SuiteConfigError` — Suite config JSON malformed or schema-invalid (INVALID_SUITE_CONFIG)
+- `HookError` — Suite hook failure (HOOK_SPAWN_FAILED, HOOK_EXIT_NONZERO, HOOK_TIMEOUT, HOOK_ABORTED)
 
 ## Development
 
@@ -231,20 +281,38 @@ src/
 
   commands/
     init-command.ts           # Project initialization
+    update-command.ts         # Skill updates
+    install-skills.ts         # Bundled skill installer
     explore-command.ts        # Breadth-first exploration
     spec-command.ts           # Spec-based exploration
+    spec-resolver.ts          # Spec file discovery and parsing
     review-command.ts         # Finding triage workflow
     analyse-command.ts        # Video analysis
     completion-command.ts     # Shell completion generation
+    item-events.ts            # Start/complete/fail event emitters
 
   core/
     parse-verbose.ts          # Verbose flag parsing
+    parse-timeout-seconds.ts  # Timeout flag parsing
     completion-generator.ts   # Bash/zsh completion script generation
     last-path.ts              # Last findings path tracking
 
   shell/
     app-context.ts            # Read app.md and explore.md
     xqa-directory.ts          # Locate .xqa directory
+    preflight.ts              # Environment preflight checks
+    display-factory.ts        # Solo and suite display factories
+    debug-logger.ts           # Debug event logging
+    debug-agent-events.ts     # Agent event debug formatter
+    debug-suite-events.ts     # Suite event debug formatter
+    debug-logger-core.ts      # Pure logging helpers
+    trigger-abort.ts          # Abort signal plumbing
+
+  suite/
+    types.ts                  # Suite work-item and findings types
+    core/                     # Pure: config parser, item builders, hook env, queue
+    shell/                    # I/O: worker pool, hook runner, findings writer
+    commands/                 # run-command, execute-item, suite-run-context
 
   __tests__/
     *.test.ts                 # Test files co-located with src/

package/dist/xqa.cjs

@@ -3733,7 +3733,7 @@ var require_index_cjs = __commonJS({
     }
     var fromPromise = ResultAsync14.fromPromise;
     var fromSafePromise2 = ResultAsync14.fromSafePromise;
-    var fromAsyncThrowable10 = ResultAsync14.fromThrowable;
+    var fromAsyncThrowable9 = ResultAsync14.fromThrowable;
     var combineResultList = (resultList) => {
       let acc = ok21([]);
       for (const result of resultList) {
@@ -3950,7 +3950,7 @@ var require_index_cjs = __commonJS({
     exports2.ResultAsync = ResultAsync14;
     exports2.err = err20;
     exports2.errAsync = errAsync8;
-    exports2.fromAsyncThrowable = fromAsyncThrowable10;
+    exports2.fromAsyncThrowable = fromAsyncThrowable9;
     exports2.fromPromise = fromPromise;
     exports2.fromSafePromise = fromSafePromise2;
     exports2.fromThrowable = fromThrowable15;
@@ -52351,27 +52351,13 @@ var DEFAULT_LONG_PRESS_DURATION_MS = 500;
 var MS_PER_SECOND = 1e3;
 var DEFAULT_SWIPE_DURATION_SECONDS = 0.1;
 var ENTER_KEY_CODE = "0x28";
-var TAP_SCHEMA = { x: external_exports.number(), y: external_exports.number() };
-var LONG_PRESS_SCHEMA = { x: external_exports.number(), y: external_exports.number(), duration: external_exports.number().optional() };
-var SWIPE_SCHEMA = {
-  x_start: external_exports.number(),
-  y_start: external_exports.number(),
-  x_end: external_exports.number(),
-  y_end: external_exports.number(),
-  duration: external_exports.number().positive().optional().describe(
-    "Gesture duration in seconds. Smaller values (e.g. 0.1) produce a flick that scrolls lists and dismisses sheets; larger values (e.g. 0.5+) produce a slow drag suitable for reordering or panning. Defaults to 0.1s (flick)."
-  )
-};
-var TYPE_TEXT_SCHEMA = { text: external_exports.string(), submit: external_exports.boolean().optional() };
-var PRESS_BUTTON_SCHEMA = {
-  button: external_exports.enum(["HOME", "LOCK", "SIRI", "SIDE_BUTTON", "APPLE_PAY"])
-};
 function errorResult2(error48) {
   return {
     content: [{ type: "text", text: `Error: ${String(error48.cause)}` }],
     isError: true
   };
 }
+var TAP_SCHEMA = { x: external_exports.number(), y: external_exports.number() };
 function buildTapArguments(resolvedUdid, input) {
   return ["ui", "tap", "--udid", resolvedUdid, String(input.x), String(input.y)];
 }
@@ -52406,6 +52392,23 @@ async function handleDoubleTap(input) {
     ]
   };
 }
+function createTapTool(udid = "booted") {
+  return _x(
+    "tap",
+    "Tap on the screen at the given coordinates.",
+    TAP_SCHEMA,
+    async ({ x, y: y6 }) => handleTap({ udid, x, y: y6 })
+  );
+}
+function createDoubleTapTool(udid = "booted") {
+  return _x(
+    "double_tap",
+    "Double-tap on the screen at the given coordinates.",
+    TAP_SCHEMA,
+    async ({ x, y: y6 }) => handleDoubleTap({ udid, x, y: y6 })
+  );
+}
+var LONG_PRESS_SCHEMA = { x: external_exports.number(), y: external_exports.number(), duration: external_exports.number().optional() };
 function buildLongPressArguments(resolvedUdid, input) {
   return [
     "ui",
@@ -52434,8 +52437,39 @@ async function handleLongPress(input) {
     ]
   };
 }
+function createLongPressTool(udid = "booted") {
+  return _x(
+    "long_press",
+    "Long-press on the screen at the given coordinates.",
+    LONG_PRESS_SCHEMA,
+    async ({ x, y: y6, duration: duration3 }) => handleLongPress({ udid, x, y: y6, duration: duration3 ?? DEFAULT_LONG_PRESS_DURATION_MS })
+  );
+}
+var SWIPE_SCHEMA = {
+  x_start: external_exports.number(),
+  y_start: external_exports.number(),
+  x_end: external_exports.number(),
+  y_end: external_exports.number(),
+  duration: external_exports.number().positive().optional().describe(
+    "Seconds for the full gesture. Velocity = distance / duration \u2014 raise duration at fixed distance to slow the gesture and reduce momentum. Default 0.1s (flick) works for short lists; raise to 0.4\u20130.8 for controlled scrolling on long lists where the flick overshoots."
+  ),
+  delta: external_exports.number().positive().optional().describe(
+    "Pixel distance between interpolated touch points along the swipe path. Smaller values (e.g. 5) produce a denser event stream \u2014 smoother motion and more controllable stop-velocity, recommended when combining with a raised duration to tame long-list overshoot. Larger values produce coarser strokes. Omit to use idb defaults."
+  )
+};
+function toSwipeInput(udid, params) {
+  return {
+    udid,
+    xStart: params.x_start,
+    yStart: params.y_start,
+    xEnd: params.x_end,
+    yEnd: params.y_end,
+    duration: params.duration ?? DEFAULT_SWIPE_DURATION_SECONDS,
+    delta: params.delta
+  };
+}
 function buildSwipeArguments(resolvedUdid, input) {
-  return [
+  const arguments_ = [
     "ui",
     "swipe",
     "--udid",
@@ -52447,6 +52481,10 @@ function buildSwipeArguments(resolvedUdid, input) {
     "--duration",
     String(input.duration)
   ];
+  if (input.delta !== void 0) {
+    arguments_.push("--delta", String(input.delta));
+  }
+  return arguments_;
 }
 async function handleSwipe(input) {
   const result = await resolveUdid(input.udid).andThen(
@@ -52464,6 +52502,15 @@ async function handleSwipe(input) {
     ]
   };
 }
+function createSwipeTool(udid = "booted") {
+  return _x(
+    "swipe",
+    "Swipe on the screen from one point to another. Default duration 0.1s produces a flick \u2014 use for scrolling lists, dismissing sheets, triggering paging. Use duration 0.5+ for slow drag (reorder, pan). For long lists where default flick overshoots: shorten swipe distance AND raise duration to 0.4\u20130.8 to lower velocity; optionally lower delta for denser touch events and a more controllable stop. Omitting duration uses the flick default.",
+    SWIPE_SCHEMA,
+    async (params) => handleSwipe(toSwipeInput(udid, params))
+  );
+}
+var TYPE_TEXT_SCHEMA = { text: external_exports.string(), submit: external_exports.boolean().optional() };
 async function handleTypeText({ udid, text, submit }) {
   const result = await resolveUdid(udid).andThen((resolvedUdid) => {
     const typeResult = runCommand("idb", ["ui", "text", "--udid", resolvedUdid, text]);
@@ -52479,6 +52526,17 @@ async function handleTypeText({ udid, text, submit }) {
   }
   return { content: [{ type: "text", text: `Typed: ${text}` }] };
 }
+function createTypeTextTool(udid = "booted") {
+  return _x(
+    "type_text",
+    "Type text into the currently focused element.",
+    TYPE_TEXT_SCHEMA,
+    async ({ text, submit }) => handleTypeText({ udid, text, submit: submit ?? false })
+  );
+}
+var PRESS_BUTTON_SCHEMA = {
+  button: external_exports.enum(["HOME", "LOCK", "SIRI", "SIDE_BUTTON", "APPLE_PAY"])
+};
 async function handlePressButton(udid, button) {
   const result = await resolveUdid(udid).andThen(
     (resolvedUdid) => runCommand("idb", ["ui", "button", "--udid", resolvedUdid, button])
@@ -52488,56 +52546,6 @@ async function handlePressButton(udid, button) {
   }
   return { content: [{ type: "text", text: `Pressed button: ${button}` }] };
 }
-function createTapTool(udid = "booted") {
-  return _x(
-    "tap",
-    "Tap on the screen at the given coordinates.",
-    TAP_SCHEMA,
-    async ({ x, y: y6 }) => handleTap({ udid, x, y: y6 })
-  );
-}
-function createDoubleTapTool(udid = "booted") {
-  return _x(
-    "double_tap",
-    "Double-tap on the screen at the given coordinates.",
-    TAP_SCHEMA,
-    async ({ x, y: y6 }) => handleDoubleTap({ udid, x, y: y6 })
-  );
-}
-function createLongPressTool(udid = "booted") {
-  return _x(
-    "long_press",
-    "Long-press on the screen at the given coordinates.",
-    LONG_PRESS_SCHEMA,
-    async ({ x, y: y6, duration: duration3 }) => handleLongPress({ udid, x, y: y6, duration: duration3 ?? DEFAULT_LONG_PRESS_DURATION_MS })
-  );
-}
-function toSwipeInput(udid, params) {
-  return {
-    udid,
-    xStart: params.x_start,
-    yStart: params.y_start,
-    xEnd: params.x_end,
-    yEnd: params.y_end,
-    duration: params.duration ?? DEFAULT_SWIPE_DURATION_SECONDS
-  };
-}
-function createSwipeTool(udid = "booted") {
-  return _x(
-    "swipe",
-    "Swipe on the screen from one point to another. `duration` (seconds) controls gesture velocity: the default 0.1s produces a flick that scrolls lists, dismisses sheets and triggers paging; pass a larger value (e.g. 0.5+) for a slow drag suitable for reordering or panning. Omitting `duration` uses the flick default.",
-    SWIPE_SCHEMA,
-    async (params) => handleSwipe(toSwipeInput(udid, params))
-  );
-}
-function createTypeTextTool(udid = "booted") {
-  return _x(
-    "type_text",
-    "Type text into the currently focused element.",
-    TYPE_TEXT_SCHEMA,
-    async ({ text, submit }) => handleTypeText({ udid, text, submit: submit ?? false })
-  );
-}
 function createPressButtonTool(udid = "booted") {
   return _x(
     "press_button",
@@ -52855,8 +52863,6 @@ function resolveRunPaths({ outputDirectory, runId, date: date5 }) {
   return (0, import_neverthrow8.ok)({
     baseDir: baseDirectory,
     videoPath: import_node_path2.default.join(baseDirectory, "recording.mp4"),
-    videoPath2x: import_node_path2.default.join(baseDirectory, "recording_2x.mp4"),
-    videoPath4x: import_node_path2.default.join(baseDirectory, "recording_4x.mp4"),
     findingsPath: import_node_path2.default.join(baseDirectory, "findings.json"),
     screenshotsDir: import_node_path2.default.join(baseDirectory, "screenshots")
   });
@@ -56115,24 +56121,13 @@ function makePollTick(onEvent) {
     });
   };
 }
-function resolveVideoPath(artifacts, variant) {
-  if (variant === "2x") {
-    return artifacts.videoPath2x;
-  }
-  if (variant === "4x") {
-    return artifacts.videoPath4x;
-  }
-  return artifacts.videoPath;
-}
 function buildRunContext(artifacts, config3) {
-  const variant = config3?.videoVariant ?? "4x";
   return {
     onEvent: config3?.onEvent === void 0 ? void 0 : safeHandler(config3.onEvent),
     apiKey: config3?.apiKey ?? "",
     model: config3?.model ?? DEFAULT_MODEL,
-    variant,
     start: Date.now(),
-    videoPath: resolveVideoPath(artifacts, variant),
+    videoPath: artifacts.videoPath,
     prompt: buildAnalyserPrompt(artifacts.snapshots)
   };
 }
@@ -56162,11 +56157,11 @@ function runUploadPipeline(context) {
 }
 function runAnalyser(artifacts, config3) {
   const context = buildRunContext(artifacts, config3);
-  const { onEvent, variant, start, videoPath } = context;
+  const { onEvent, start, videoPath } = context;
   onEvent?.({ type: "STAGE_START", agent: "analyser" });
   if (!videoPath) {
     emitStageEnd(onEvent, start);
-    return (0, import_neverthrow10.errAsync)({ type: "VIDEO_PATH_MISSING", variant });
+    return (0, import_neverthrow10.errAsync)({ type: "VIDEO_PATH_MISSING" });
   }
   return runUploadPipeline(context);
 }
@@ -62790,17 +62785,6 @@ function runQuery(prompt, config3) {
 function collectAgentOutput(prompt, config3) {
   return runQuery(prompt, config3).mapErr((cause) => ({ type: "QUERY_FAILED", cause }));
 }
-async function runFfmpeg(arguments_) {
-  const { promise: promise2, resolve, reject } = Promise.withResolvers();
-  (0, import_node_child_process4.execFile)("ffmpeg", arguments_, (error48) => {
-    if (error48) {
-      reject(error48);
-    } else {
-      resolve(true);
-    }
-  });
-  await promise2;
-}
 function spawnRecorder(outputPath) {
   const safeMkdirSync = (0, import_neverthrow20.fromThrowable)(import_node_fs.mkdirSync, (cause) => cause);
   const safeSpawn2 = (0, import_neverthrow20.fromThrowable)(
@@ -62874,35 +62858,6 @@ function stopRecording(handle) {
     (cause) => ({ type: "STOP_FAILED", cause })
   );
 }
-function speedUpVideo({
-  inputPath,
-  factor,
-  outputPath
-}) {
-  const pts = String(1 / factor);
-  return (0, import_neverthrow20.fromAsyncThrowable)(
-    runFfmpeg,
-    (cause) => ({ type: "PROCESS_FAILED", cause })
-  )(["-i", inputPath, "-filter:v", `setpts=${pts}*PTS`, "-an", "-y", outputPath]).map(
-    () => outputPath
-  );
-}
-var SPEED_2X = 2;
-var SPEED_4X = 4;
-function applySpeedUpVariants({
-  result,
-  params,
-  toRecordingError
-}) {
-  const { findings, snapshots } = result;
-  const { videoPath, videoPath2x, videoPath4x, signal } = params;
-  if (signal?.aborted) {
-    return (0, import_neverthrow19.okAsync)({ findings, snapshots });
-  }
-  return speedUpVideo({ inputPath: videoPath, factor: SPEED_2X, outputPath: videoPath2x }).mapErr(toRecordingError).andThen(
-    () => speedUpVideo({ inputPath: videoPath, factor: SPEED_4X, outputPath: videoPath4x }).mapErr(toRecordingError).map(() => ({ findings, snapshots }))
-  );
-}
 function runWithRecording(handle, collectOutput) {
   const toRecordingError = (cause) => ({
     type: "RECORDING_FAILED",
@@ -62931,7 +62886,7 @@ function startAndRun(params) {
     }).mapErr((error48) => {
       signal?.removeEventListener("abort", onAbort);
       return error48;
-    }).andThen((result) => applySpeedUpVariants({ result, params, toRecordingError }));
+    });
   });
 }
 var TOOL_SELECTION_SECTION = `## Tool Selection
@@ -63405,15 +63360,13 @@ function toArtifacts(result, runPaths) {
   return {
     findings: result.findings,
     videoPath: runPaths.videoPath,
-    videoPath2x: runPaths.videoPath2x,
-    videoPath4x: runPaths.videoPath4x,
     snapshots: result.snapshots
   };
 }
 function emitStageEnd3(safeConfig, start) {
   safeConfig.onEvent?.({ type: "STAGE_END", agent: "explorer", durationMs: Date.now() - start });
 }
-var EMPTY_RUN_PATHS = { videoPath: "", videoPath2x: "", videoPath4x: "" };
+var EMPTY_RUN_PATHS = { videoPath: "" };
 function collectWithoutRecording({
   safeConfig,
   prompt,
@@ -63438,8 +63391,6 @@ function collectAndFinalize({
   }
   return startAndRun({
     videoPath: runPaths.videoPath,
-    videoPath2x: runPaths.videoPath2x,
-    videoPath4x: runPaths.videoPath4x,
     signal: safeConfig.signal,
     collectOutput: () => collectAgentOutput(prompt, safeConfig)
   }).map((result) => {
@@ -67433,7 +67384,6 @@ var ALLOWED_TOOLS = [...MOBILE_IOS_TOOLS];
 var MS_PER_SECOND4 = 1e3;
 var DEFAULT_ABORT_EXIT_CODE = 130;
 var IDB_INSTALL_MESSAGE = "idb is not installed. Run:\n  brew install idb-companion\n  pipx install fb-idb\n";
-var FFMPEG_INSTALL_MESSAGE = "ffmpeg is not installed. Run:\n  brew install ffmpeg\n";
 
 // src/shell/debug-logger-core.ts
 var ELAPSED_PAD = 8;
@@ -67715,7 +67665,7 @@ var JSON_INDENT = 2;
 var ITEM_ID = "analyse";
 var ITEM_NAME = "analyse";
 function buildArtifacts(videoPath) {
-  return { videoPath, videoPath2x: "", videoPath4x: videoPath, findings: [], snapshots: [] };
+  return { videoPath, findings: [], snapshots: [] };
 }
 async function checkVideoPathExists(videoPath) {
   const safeAccess = (0, import_neverthrow36.fromAsyncThrowable)(import_promises17.access, () => ({ type: "FILE_NOT_FOUND" }));
@@ -67762,7 +67712,6 @@ async function runAnalysisAndExit(input) {
   const state = { identity, startedAt };
   const result = await runAnalysis(input.artifacts, {
     apiKey: input.apiKey,
-    videoVariant: "1x",
     onEvent
   });
   result.match(
@@ -67783,7 +67732,7 @@ function ensureApiKey(config3) {
   }
   return apiKey;
 }
-async function resolveVideoPath2(videoPath) {
+async function resolveVideoPath(videoPath) {
   if (videoPath === void 0) {
     process.stderr.write('A video path is required. Pass the path printed by "xqa explore".\n');
     process.exit(1);
@@ -67802,7 +67751,7 @@ async function runAnalyseCommand(input) {
   if (apiKey === void 0) {
     return;
   }
-  const videoPath = await resolveVideoPath2(input.videoPath);
+  const videoPath = await resolveVideoPath(input.videoPath);
   if (videoPath === void 0) {
     return;
   }
@@ -68001,35 +67950,8 @@ function readExploreContext(xqaDirectory) {
   return readContextFile(xqaDirectory, "explore.md");
 }
 
-// src/shell/ffmpeg-check.ts
-var import_node_child_process5 = require("node:child_process");
-var import_neverthrow40 = __toESM(require_index_cjs(), 1);
-async function whichFfmpeg() {
-  const { promise: promise2, resolve, reject } = Promise.withResolvers();
-  (0, import_node_child_process5.execFile)("which", ["ffmpeg"], (error48, stdout) => {
-    if (error48) {
-      reject(error48);
-    } else {
-      resolve(stdout);
-    }
-  });
-  return promise2;
-}
-var safeWhichFfmpeg = (0, import_neverthrow40.fromAsyncThrowable)(
-  whichFfmpeg,
-  () => ({ type: "FFMPEG_NOT_FOUND" })
-);
-function checkFfmpegAvailable() {
-  return safeWhichFfmpeg();
-}
-
 // src/shell/preflight.ts
 async function runPreflightChecks() {
-  const ffmpegCheck = await checkFfmpegAvailable();
-  if (ffmpegCheck.isErr()) {
-    process.stderr.write(FFMPEG_INSTALL_MESSAGE);
-    return 1;
-  }
   const idbCheck = await checkIdbAvailable();
   if (idbCheck.isErr()) {
     process.stderr.write(IDB_INSTALL_MESSAGE);
@@ -68217,7 +68139,7 @@ var import_node_fs6 = require("node:fs");
 var import_node_path12 = __toESM(require("node:path"), 1);
 
 // src/commands/install-skills.ts
-var import_node_child_process6 = require("node:child_process");
+var import_node_child_process5 = require("node:child_process");
 var import_node_fs5 = require("node:fs");
 var import_node_path11 = __toESM(require("node:path"), 1);
 var import_node_url = require("node:url");
@@ -68228,7 +68150,7 @@ function resolveSkillsRoot() {
 function installSkills() {
   const skillsRoot = resolveSkillsRoot();
   for (const skill of (0, import_node_fs5.readdirSync)(skillsRoot)) {
-    (0, import_node_child_process6.spawnSync)("npx", ["skills", "add", import_node_path11.default.join(skillsRoot, skill), "-y"], {
+    (0, import_node_child_process5.spawnSync)("npx", ["skills", "add", import_node_path11.default.join(skillsRoot, skill), "-y"], {
       stdio: "inherit"
     });
   }
@@ -68306,7 +68228,7 @@ function runInitCommand() {
 // src/commands/review-command.ts
 var import_node_fs7 = require("node:fs");
 var import_node_path14 = __toESM(require("node:path"), 1);
-var import_neverthrow42 = __toESM(require_index_cjs(), 1);
+var import_neverthrow41 = __toESM(require_index_cjs(), 1);
 
 // ../../node_modules/.pnpm/@inquirer+core@10.3.2_@types+node@22.19.15/node_modules/@inquirer/core/dist/esm/lib/key.js
 var isUpKey = (key, keybindings = []) => (
@@ -70711,7 +70633,7 @@ var esm_default11 = createPrompt((config3, done) => {
 });
 
 // src/review-session.ts
-var import_neverthrow41 = __toESM(require_index_cjs(), 1);
+var import_neverthrow40 = __toESM(require_index_cjs(), 1);
 var CONFIDENCE_PERCENT = 100;
 var FLOW_COL_WIDTH = 35;
 var TRIGGER_COL_WIDTH = 16;
@@ -70864,15 +70786,15 @@ async function runInteractiveLoop(findings, existing) {
   }
   return { staged: state.staged, undoneKeys: state.undoneKeys };
 }
-var safeRunInteractiveLoop = (0, import_neverthrow41.fromAsyncThrowable)(
+var safeRunInteractiveLoop = (0, import_neverthrow40.fromAsyncThrowable)(
   runInteractiveLoop,
   (error48) => error48 instanceof Error && error48.name === "ExitPromptError" ? "exit-prompt" : "unexpected"
 );
 
 // src/commands/review-command.ts
-var safeReadFile3 = (0, import_neverthrow42.fromThrowable)((filePath) => (0, import_node_fs7.readFileSync)(filePath, "utf8"));
-var safeParseJson3 = (0, import_neverthrow42.fromThrowable)(JSON.parse);
-var safeWrite = (0, import_neverthrow42.fromThrowable)((filePath, content) => {
+var safeReadFile3 = (0, import_neverthrow41.fromThrowable)((filePath) => (0, import_node_fs7.readFileSync)(filePath, "utf8"));
+var safeParseJson3 = (0, import_neverthrow41.fromThrowable)(JSON.parse);
+var safeWrite = (0, import_neverthrow41.fromThrowable)((filePath, content) => {
   (0, import_node_fs7.writeFileSync)(filePath, content);
 });
 function readLastPath(xqaDirectory) {
@@ -70889,13 +70811,13 @@ function isPipelineOutput(data) {
 function readFindings(filePath) {
   const readResult = safeReadFile3(filePath);
   if (readResult.isErr()) {
-    return (0, import_neverthrow42.err)("not-found");
+    return (0, import_neverthrow41.err)("not-found");
   }
   return safeParseJson3(readResult.value).mapErr(() => "invalid").andThen((data) => {
     if (!isPipelineOutput(data)) {
-      return (0, import_neverthrow42.err)("invalid");
+      return (0, import_neverthrow41.err)("invalid");
     }
-    return (0, import_neverthrow42.ok)(data);
+    return (0, import_neverthrow41.ok)(data);
   });
 }
 function loadExistingDismissals(filePath) {
@@ -70968,7 +70890,7 @@ function resolveAndReadFindings(findingsPath, xqaDirectory) {
       "No findings path provided and no last path found. Run: xqa review <findings-path>\n"
     );
     process.exit(1);
-    return (0, import_neverthrow42.err)();
+    return (0, import_neverthrow41.err)();
   }
   const resolvedPath = resolvedPathResult.value;
   const findingsResult = readFindings(resolvedPath);
@@ -70981,9 +70903,9 @@ function resolveAndReadFindings(findingsPath, xqaDirectory) {
 `);
     }
     process.exit(1);
-    return (0, import_neverthrow42.err)();
+    return (0, import_neverthrow41.err)();
   }
-  return (0, import_neverthrow42.ok)({ resolvedPath, output: findingsResult.value });
+  return (0, import_neverthrow41.ok)({ resolvedPath, output: findingsResult.value });
 }
 async function runReviewLoop({
   findings,
@@ -71057,40 +70979,40 @@ function stripExtensions(filename) {
 // src/commands/spec-resolver.ts
 var import_node_fs8 = require("node:fs");
 var import_node_path16 = __toESM(require("node:path"), 1);
-var import_neverthrow44 = __toESM(require_index_cjs(), 1);
+var import_neverthrow43 = __toESM(require_index_cjs(), 1);
 
 // src/spec-frontmatter.ts
-var import_neverthrow43 = __toESM(require_index_cjs(), 1);
+var import_neverthrow42 = __toESM(require_index_cjs(), 1);
 var FRONTMATTER_OPEN_LEN = 4;
 var FRONTMATTER_MARKER_LEN = 3;
 function extractFrontmatterBlock(content) {
   const normalized = content.replaceAll("\r\n", "\n");
   if (!normalized.startsWith("---")) {
-    return (0, import_neverthrow43.err)({ type: "MISSING_FRONTMATTER" });
+    return (0, import_neverthrow42.err)({ type: "MISSING_FRONTMATTER" });
   }
   const end = normalized.indexOf("\n---", FRONTMATTER_MARKER_LEN);
   if (end === -1) {
-    return (0, import_neverthrow43.err)({ type: "MISSING_FRONTMATTER" });
+    return (0, import_neverthrow42.err)({ type: "MISSING_FRONTMATTER" });
   }
-  return (0, import_neverthrow43.ok)(normalized.slice(FRONTMATTER_OPEN_LEN, end));
+  return (0, import_neverthrow42.ok)(normalized.slice(FRONTMATTER_OPEN_LEN, end));
 }
 function parseTimeout(fields) {
   const raw = fields.get("timeout");
   if (raw === void 0) {
-    return (0, import_neverthrow43.ok)(raw);
+    return (0, import_neverthrow42.ok)(raw);
   }
   const parsed = Number(raw);
   if (Number.isNaN(parsed) || parsed <= 0) {
-    return (0, import_neverthrow43.err)({ type: "PARSE_ERROR", cause: `invalid timeout: ${raw}` });
+    return (0, import_neverthrow42.err)({ type: "PARSE_ERROR", cause: `invalid timeout: ${raw}` });
   }
-  return (0, import_neverthrow43.ok)(parsed);
+  return (0, import_neverthrow42.ok)(parsed);
 }
 function parseSpecFrontmatter(content) {
   return extractFrontmatterBlock(content).andThen((block) => {
     const fields = parseYamlFields(block);
     const feature = fields.get("feature");
     if (feature === void 0) {
-      return (0, import_neverthrow43.err)({ type: "MISSING_FIELD", field: "feature" });
+      return (0, import_neverthrow42.err)({ type: "MISSING_FIELD", field: "feature" });
     }
     return parseTimeout(fields).map((timeout) => ({ feature, timeout }));
   });
@@ -71112,12 +71034,12 @@ function parseYamlFields(block) {
 }
 
 // src/commands/spec-resolver.ts
-var safeReadFile4 = (0, import_neverthrow44.fromThrowable)((filePath) => (0, import_node_fs8.readFileSync)(filePath, "utf8"));
-var safeReaddir = (0, import_neverthrow44.fromThrowable)(
+var safeReadFile4 = (0, import_neverthrow43.fromThrowable)((filePath) => (0, import_node_fs8.readFileSync)(filePath, "utf8"));
+var safeReaddir = (0, import_neverthrow43.fromThrowable)(
   (directory) => (0, import_node_fs8.readdirSync)(directory, { recursive: true, encoding: "utf8" })
 );
 var CANCEL = "xqa:cancel";
-var safeSelect = import_neverthrow44.ResultAsync.fromThrowable(
+var safeSelect = import_neverthrow43.ResultAsync.fromThrowable(
   esm_default11,
   (error48) => error48 instanceof Error && error48.name === "ExitPromptError" ? "cancelled" : "failed"
 );
@@ -71307,7 +71229,7 @@ function runUpdateCommand() {
 var import_node_path18 = __toESM(require("node:path"), 1);
 var import_node_url2 = require("node:url");
 var import_dotenv = __toESM(require_main(), 1);
-var import_neverthrow45 = __toESM(require_index_cjs(), 1);
+var import_neverthrow44 = __toESM(require_index_cjs(), 1);
 
 // ../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/external.js
 var external_exports2 = {};
@@ -75368,10 +75290,10 @@ function loadConfig() {
     const messages = result.error.issues.map(
       (issue2) => `  - ${issue2.path.join(".")}: ${issue2.message}`
     );
-    return (0, import_neverthrow45.err)({ type: "INVALID_CONFIG", message: `Configuration error:
+    return (0, import_neverthrow44.err)({ type: "INVALID_CONFIG", message: `Configuration error:
 ${messages.join("\n")}` });
   }
-  return (0, import_neverthrow45.ok)(result.data);
+  return (0, import_neverthrow44.ok)(result.data);
 }
 
 // src/core/parse-timeout-seconds.ts
@@ -75404,7 +75326,7 @@ function parseVerboseOption(value) {
 
 // src/pid-lock.ts
 var import_node_fs9 = require("node:fs");
-var import_neverthrow46 = __toESM(require_index_cjs(), 1);
+var import_neverthrow45 = __toESM(require_index_cjs(), 1);
 var PID_FILE = "/tmp/xqa.pid";
 var SIGINT_EXIT_CODE = 130;
 var SIGTERM_EXIT_CODE = 143;
@@ -75413,7 +75335,7 @@ var HARD_TIMEOUT_MS = 1e4;
 var cleanup = () => {
   (0, import_node_fs9.rmSync)(PID_FILE, { force: true });
 };
-var checkProcessRunning = (0, import_neverthrow46.fromThrowable)(
+var checkProcessRunning = (0, import_neverthrow45.fromThrowable)(
   (pid) => {
     process.kill(pid, 0);
     return true;
@@ -75479,17 +75401,17 @@ function acquireLock() {
 // src/shell/xqa-directory.ts
 var import_node_fs10 = require("node:fs");
 var import_node_path19 = __toESM(require("node:path"), 1);
-var import_neverthrow47 = __toESM(require_index_cjs(), 1);
+var import_neverthrow46 = __toESM(require_index_cjs(), 1);
 function findXqaDirectory(startDirectory) {
   let current = startDirectory;
   for (; ; ) {
     const candidate = import_node_path19.default.join(current, ".xqa");
     if ((0, import_node_fs10.existsSync)(candidate)) {
-      return (0, import_neverthrow47.ok)(candidate);
+      return (0, import_neverthrow46.ok)(candidate);
     }
     const parent = import_node_path19.default.dirname(current);
     if (parent === current) {
-      return (0, import_neverthrow47.err)({ type: "XQA_NOT_INITIALIZED" });
+      return (0, import_neverthrow46.err)({ type: "XQA_NOT_INITIALIZED" });
     }
     current = parent;
   }
@@ -75499,11 +75421,11 @@ function findXqaDirectory(startDirectory) {
 var import_promises21 = __toESM(require("node:fs/promises"), 1);
 var import_node_path23 = __toESM(require("node:path"), 1);
 var import_fast_glob = __toESM(require_out4(), 1);
-var import_neverthrow55 = __toESM(require_index_cjs(), 1);
+var import_neverthrow54 = __toESM(require_index_cjs(), 1);
 
 // src/suite/core/suite-config-parser.ts
+var import_neverthrow47 = __toESM(require_index_cjs(), 1);
 var import_neverthrow48 = __toESM(require_index_cjs(), 1);
-var import_neverthrow49 = __toESM(require_index_cjs(), 1);
 var RESERVED_HOOK_ENV_KEYS = [
   "XQA_SIM_UDID",
   "XQA_ITEM_ID",
@@ -75555,7 +75477,7 @@ var suiteConfigSchema = external_exports2.object({
 }).refine((data) => data.specs.length > 0 || data.freestyle.length > 0, {
   message: "Suite must declare at least one spec or freestyle entry"
 });
-var safeJsonParse4 = (0, import_neverthrow48.fromThrowable)(
+var safeJsonParse4 = (0, import_neverthrow47.fromThrowable)(
   JSON.parse,
   (cause) => ({
     type: "INVALID_SUITE_CONFIG",
@@ -75589,16 +75511,16 @@ function parseSuiteConfig(raw) {
   return safeJsonParse4(raw).andThen((data) => {
     const parsed = suiteConfigSchema.safeParse(data);
     if (!parsed.success) {
-      return (0, import_neverthrow49.err)({ type: "INVALID_SUITE_CONFIG", cause: parsed.error });
+      return (0, import_neverthrow48.err)({ type: "INVALID_SUITE_CONFIG", cause: parsed.error });
     }
     const hooks = normalizeHooks(parsed.data.hooks);
     if (hooks === void 0) {
-      return (0, import_neverthrow49.ok)({
+      return (0, import_neverthrow48.ok)({
         specs: parsed.data.specs,
         freestyle: parsed.data.freestyle
       });
     }
-    return (0, import_neverthrow49.ok)({
+    return (0, import_neverthrow48.ok)({
       specs: parsed.data.specs,
       freestyle: parsed.data.freestyle,
       hooks
@@ -75657,7 +75579,7 @@ function buildFreestyleItems(entries) {
 // src/suite/shell/suite-findings-writer.ts
 var import_promises19 = __toESM(require("node:fs/promises"), 1);
 var import_node_path20 = __toESM(require("node:path"), 1);
-var import_neverthrow50 = __toESM(require_index_cjs(), 1);
+var import_neverthrow49 = __toESM(require_index_cjs(), 1);
 var INDENT_SPACES = 2;
 function writeSuiteFindings(findings, options) {
   const directory = import_node_path20.default.join(
@@ -75669,7 +75591,7 @@ function writeSuiteFindings(findings, options) {
   );
   const finalPath = import_node_path20.default.join(directory, "findings.json");
   const temporaryPath = `${finalPath}.tmp`;
-  const safeWriteAtomically = import_neverthrow50.ResultAsync.fromThrowable(
+  const safeWriteAtomically = import_neverthrow49.ResultAsync.fromThrowable(
     async () => {
       await import_promises19.default.mkdir(directory, { recursive: true });
       await import_promises19.default.writeFile(temporaryPath, JSON.stringify(findings, void 0, INDENT_SPACES));
@@ -75682,7 +75604,7 @@ function writeSuiteFindings(findings, options) {
 }
 
 // src/suite/shell/worker-pool.ts
-var import_neverthrow53 = __toESM(require_index_cjs(), 1);
+var import_neverthrow52 = __toESM(require_index_cjs(), 1);
 
 // src/suite/core/priority-queue.ts
 var PriorityQueue = class {
@@ -75866,7 +75788,7 @@ function recordHookFailure(input) {
 }
 
 // src/suite/shell/hook-invoker.ts
-var import_neverthrow52 = __toESM(require_index_cjs(), 1);
+var import_neverthrow51 = __toESM(require_index_cjs(), 1);
 
 // src/suite/core/hook-env-builder.ts
 function buildReservedKeys(input) {
@@ -75892,8 +75814,8 @@ function buildHookEnv(input) {
 }
 
 // src/suite/shell/hook-runner.ts
-var import_node_child_process7 = require("node:child_process");
-var import_neverthrow51 = __toESM(require_index_cjs(), 1);
+var import_node_child_process6 = require("node:child_process");
+var import_neverthrow50 = __toESM(require_index_cjs(), 1);
 var noop2 = () => void 0;
 function cleanup2(context) {
   clearTimeout(context.timeoutHandle);
@@ -75922,22 +75844,22 @@ function collectStderr(child, stderrReference) {
 function buildOnAbort(context) {
   return () => {
     context.child.kill("SIGTERM");
-    settle(context, (0, import_neverthrow51.err)({ type: "HOOK_ABORTED" }));
+    settle(context, (0, import_neverthrow50.err)({ type: "HOOK_ABORTED" }));
   };
 }
 function attachChildListeners(context) {
   const { child, stderrReference } = context;
   child.on("error", (cause) => {
-    settle(context, (0, import_neverthrow51.err)({ type: "HOOK_SPAWN_FAILED", cause }));
+    settle(context, (0, import_neverthrow50.err)({ type: "HOOK_SPAWN_FAILED", cause }));
   });
   child.on("exit", (code) => {
     if (code === 0) {
-      settle(context, (0, import_neverthrow51.ok)());
+      settle(context, (0, import_neverthrow50.ok)());
       return;
     }
     settle(
       context,
-      (0, import_neverthrow51.err)({
+      (0, import_neverthrow50.err)({
         type: "HOOK_EXIT_NONZERO",
         code: code ?? -1,
         stderr: stderrReference.value
@@ -75949,14 +75871,14 @@ function attachTimeout(context, timeoutMs) {
   clearTimeout(context.timeoutHandle);
   context.timeoutHandle = setTimeout(() => {
     context.child.kill("SIGTERM");
-    settle(context, (0, import_neverthrow51.err)({ type: "HOOK_TIMEOUT", timeoutMs }));
+    settle(context, (0, import_neverthrow50.err)({ type: "HOOK_TIMEOUT", timeoutMs }));
   }, timeoutMs);
 }
 function buildContext2(options) {
   const { script, cwd, env: env2, baseEnv, nodeExecPath } = options;
   const deferred = makeDeferred();
   const stderrReference = { value: "" };
-  const child = (0, import_node_child_process7.spawn)(nodeExecPath, [script], {
+  const child = (0, import_node_child_process6.spawn)(nodeExecPath, [script], {
     cwd,
     env: { ...baseEnv, ...env2 },
     stdio: ["ignore", "inherit", "pipe"]
@@ -75984,7 +75906,7 @@ async function spawnHook(options) {
   attachChildListeners(context);
   return context.deferred.promise;
 }
-var safeSpawn = import_neverthrow51.ResultAsync.fromThrowable(
+var safeSpawn = import_neverthrow50.ResultAsync.fromThrowable(
   spawnHook,
   (cause) => ({ type: "HOOK_SPAWN_FAILED", cause })
 );
@@ -76012,7 +75934,7 @@ async function invokeHook(input) {
 async function maybeInvokeHook(input) {
   const { hook } = input;
   if (hook === void 0) {
-    return (0, import_neverthrow52.ok)();
+    return (0, import_neverthrow51.ok)();
   }
   return invokeHook({ ...input, hook });
 }
@@ -76151,7 +76073,7 @@ function runWorkerPool(config3) {
   const queue = setupQueue(config3);
   const results = [];
   const suiteStartMs = Date.now();
-  const safeRun = import_neverthrow53.ResultAsync.fromThrowable(
+  const safeRun = import_neverthrow52.ResultAsync.fromThrowable(
     async () => runAllWorkers({ config: config3, queue, results, suiteStartMs }),
     (cause) => ({ type: "WORKER_POOL_FAILED", cause })
   );
@@ -76180,29 +76102,31 @@ function resolveFreestyleTimeout(item, config3) {
   }
   return config3.QA_EXPLORE_TIMEOUT_SECONDS ?? DEFAULT_FREESTYLE_TIMEOUT_SECONDS2;
 }
+function buildFreestyleExplorerConfig(input) {
+  const { item, context, simulatorUdid } = input;
+  const { config: config3, date: date5, appContext } = context;
+  return {
+    mode: "freestyle",
+    date: date5,
+    mcpServers: createDefaultMcpServers(simulatorUdid),
+    allowedTools: ALLOWED_TOOLS,
+    timeoutMs: resolveFreestyleTimeout(item, config3) * MS_PER_SECOND4,
+    appContext: composeAppContext([buildDeviceInstruction(simulatorUdid), appContext, item.prompt]),
+    buildEnv: config3.QA_BUILD_ENV,
+    cwd: ensureWorkerCwd(simulatorUdid),
+    record: true
+  };
+}
 function buildFreestylePipelineConfig(input) {
   const { item, context, signal, simulatorUdid, onEvent } = input;
-  const { config: config3, xqaDirectory, runId, date: date5, appContext } = context;
+  const { xqaDirectory, runId } = context;
   return {
     outputDir: import_node_path21.default.join(xqaDirectory, "output", item.id),
     runId,
     simulatorUdid,
     signal,
     onEvent,
-    explorer: {
-      mode: "freestyle",
-      date: date5,
-      mcpServers: createDefaultMcpServers(simulatorUdid),
-      allowedTools: ALLOWED_TOOLS,
-      timeoutMs: resolveFreestyleTimeout(item, config3) * MS_PER_SECOND4,
-      appContext: composeAppContext([
-        buildDeviceInstruction(simulatorUdid),
-        appContext,
-        item.prompt
-      ]),
-      buildEnv: config3.QA_BUILD_ENV,
-      cwd: ensureWorkerCwd(simulatorUdid)
-    }
+    explorer: buildFreestyleExplorerConfig(input)
   };
 }
 function executeFreestyleItem(input) {
@@ -76224,7 +76148,8 @@ function buildSpecPipelineConfig(input) {
       allowedTools: ALLOWED_TOOLS,
       appContext: composeAppContext([buildDeviceInstruction(simulatorUdid), appContext]),
       buildEnv: config3.QA_BUILD_ENV,
-      cwd: ensureWorkerCwd(simulatorUdid)
+      cwd: ensureWorkerCwd(simulatorUdid),
+      record: true
     }
   };
 }
@@ -76244,7 +76169,7 @@ function makeExecuteItem(context) {
 // src/suite/commands/suite-run-context.ts
 var import_promises20 = __toESM(require("node:fs/promises"), 1);
 var import_node_path22 = __toESM(require("node:path"), 1);
-var import_neverthrow54 = __toESM(require_index_cjs(), 1);
+var import_neverthrow53 = __toESM(require_index_cjs(), 1);
 
 // src/suite/core/run-id.ts
 var RUN_ID_PAD_LENGTH2 = 4;
@@ -76279,7 +76204,7 @@ function deriveSuiteId(input) {
 
 // src/suite/commands/suite-run-context.ts
 var ISO_DATE_LENGTH3 = 10;
-var safeReaddir2 = import_neverthrow54.ResultAsync.fromThrowable(
+var safeReaddir2 = import_neverthrow53.ResultAsync.fromThrowable(
   async (directoryPath) => {
     const entries = await import_promises20.default.readdir(directoryPath, { withFileTypes: true });
     return entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name);
@@ -76327,7 +76252,7 @@ async function buildSuiteRunContext(input) {
 }
 
 // src/suite/commands/run-command.ts
-var safeReadFile5 = import_neverthrow55.ResultAsync.fromThrowable(
+var safeReadFile5 = import_neverthrow54.ResultAsync.fromThrowable(
   async (filePath) => import_promises21.default.readFile(filePath, "utf8"),
   () => "READ_FAILED"
 );
@@ -76515,7 +76440,7 @@ function resolveXqaDirectory() {
   return result.value;
 }
 var program2 = new Command();
-program2.name("xqa").description("AI-powered QA agent CLI").version(`${"1.14.1"}${false ? ` (dev build +${"18d343b"})` : ""}`);
+program2.name("xqa").description("AI-powered QA agent CLI").version(`${"1.15.0"}${false ? ` (dev build +${"befb4fb"})` : ""}`);
 program2.command("init").description("Initialize a new xqa project in the current directory").action(() => {
   runInitCommand();
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exodus/xqa",
-  "version": "1.14.1",
+  "version": "1.15.0",
   "type": "module",
   "engines": {
     "node": ">=22"
@@ -26,12 +26,12 @@
     "typescript": "^5.8.3",
     "vitest": "^3.2.1",
     "zod": "^3.0.0",
-    "@qa-agents/explorer": "0.0.0",
-    "@qa-agents/mobile-ios": "0.0.0",
-    "@qa-agents/pipeline": "0.0.0",
     "@qa-agents/display": "0.0.0",
     "@qa-agents/eslint-config": "0.0.0",
+    "@qa-agents/explorer": "0.0.0",
+    "@qa-agents/mobile-ios": "0.0.0",
     "@qa-agents/shared": "0.0.0",
+    "@qa-agents/pipeline": "0.0.0",
     "@qa-agents/typescript-config": "0.0.0"
   },
   "dependencies": {