@exodus/xqa 4.0.0 → 5.1.0

package/dist/xqa.cjs

@@ -31961,12 +31961,14 @@ agents:
     # App under test build environment. 'dev' disables reporting debug overlays as bugs.
     buildEnv: dev
     capabilities:
-      # Record the simulator screen as MP4 during the run. Off by default \u2014 CI-heavy.
+      # Record the simulator screen as HEVC MP4 via simctl (no inline ffmpeg pass). Off by default \u2014 CI-heavy.
       videoRecording: false
       # Register the view_ui MCP tool so the explorer can inspect the accessibility tree. On by default; disable to reduce tool surface.
       viewUiServer: true
       # Save per-finding screenshots to the run output directory.
       findingScreenshots: true
+      # Allow the agent to read the simulator pasteboard via the read_pasteboard tool. Off by default \u2014 pasteboard contents (including any secrets copied during the run) are sent to the model provider verbatim.
+      readPasteboard: false
 
   analyser:
     # Requires GOOGLE_GENERATIVE_AI_API_KEY in environment.
@@ -45971,19 +45973,6 @@ function initConfig(options2) {
   });
 }
 
-// ../../packages/config/dist/shell/legacy-env-detector.js
-var LEGACY_ENV_VARS = [
-  "QA_RUN_ID",
-  "QA_EXPLORE_TIMEOUT_SECONDS",
-  "QA_BUILD_ENV",
-  "QA_DISMISSALS_PATH",
-  "XQA_SUITES_DIR",
-  "XQA_CWD"
-];
-function detectLegacyEnv(env3) {
-  return LEGACY_ENV_VARS.filter((name) => env3[name] !== void 0);
-}
-
 // ../../packages/config/dist/shell/loader.js
 var import_node_fs = require("node:fs");
 var import_node_path3 = __toESM(require("node:path"), 1);
@@ -46027,19 +46016,11 @@ function loadConfigSync(options2) {
   if (readResult.isErr()) {
     return (0, import_neverthrow4.err)(readResult.error);
   }
-  const validated = parseAndValidateSync({
+  return parseAndValidateSync({
     schema: options2.schema,
     text: readResult.value,
     filePath
   });
-  if (validated.isErr()) {
-    return (0, import_neverthrow4.err)(validated.error);
-  }
-  const legacy = detectLegacyEnv(options2.env);
-  if (legacy.length > 0) {
-    return (0, import_neverthrow4.err)({ type: "LEGACY_ENV_DETECTED", vars: [...legacy] });
-  }
-  return (0, import_neverthrow4.ok)(validated.value);
 }
 
 // ../../node_modules/.pnpm/commander@14.0.3/node_modules/commander/esm.mjs
@@ -46060,15 +46041,9 @@ var {
 } = import_index.default;
 
 // src/bootstrap.ts
-var import_neverthrow96 = __toESM(require_index_cjs(), 1);
+var import_neverthrow97 = __toESM(require_index_cjs(), 1);
 
 // src/config/error-formatter.ts
-function formatLegacyVariables(variables) {
-  const lines = variables.map((name) => `  ${name}`).join("\n");
-  return `Legacy environment variables detected:
-${lines}
-Move these values into .xqa/config.yaml.`;
-}
 function formatIssues(issues) {
   const lines = issues.map((issue2) => `  ${issue2.path.join(".")}: ${issue2.message}`).join("\n");
   return `Config validation failed:
@@ -46095,9 +46070,6 @@ function formatConfigError(error48) {
       return `Config file not found: ${error48.path}
 Run \`xqa init\` to generate it.`;
     }
-    case "LEGACY_ENV_DETECTED": {
-      return formatLegacyVariables(error48.vars);
-    }
     case "CONFIG_SCHEMA_INVALID": {
       return formatIssues(error48.issues);
     }
@@ -63987,6 +63959,41 @@ function createPressButtonTool(udid = "booted") {
     async ({ button }) => handlePressButton(udid, button)
   );
 }
+var READ_PASTEBOARD_TOOL_NAME = "mcp__mobile-ios__read_pasteboard";
+var MAX_PASTEBOARD_LENGTH = 4096;
+var READ_PASTEBOARD_SCHEMA = {};
+var READ_PASTEBOARD_DESCRIPTION = [
+  "Read current simulator pasteboard (clipboard) as text.",
+  'Use ONLY to verify a copy-to-clipboard action the user just performed (e.g. confirm a "Copy address" button wrote the expected value).',
+  'DO NOT call on screens showing secrets, seed phrases, recovery words, private keys, passwords, or 2FA codes, or after any "reveal/backup/export" flow \u2014 pasteboard contents are sent to the model provider verbatim.',
+  `Output is truncated to ${String(MAX_PASTEBOARD_LENGTH)} characters; trailing newlines are stripped; returns empty string when the pasteboard is empty.`
+].join(" ");
+function truncatePasteboard(raw) {
+  const trimmed = raw.replace(/\r?\n+$/, "");
+  if (trimmed.length <= MAX_PASTEBOARD_LENGTH) {
+    return trimmed;
+  }
+  const overflow = trimmed.length - MAX_PASTEBOARD_LENGTH;
+  return `${trimmed.slice(0, MAX_PASTEBOARD_LENGTH)}
+[truncated: ${String(overflow)} more chars]`;
+}
+async function handleReadPasteboard(udid) {
+  return resolveUdid(udid).andThen((resolvedUdid) => runCommand("xcrun", ["simctl", "pbpaste", resolvedUdid])).match(
+    (value) => ({ content: [{ type: "text", text: truncatePasteboard(value) }] }),
+    (error48) => ({
+      content: [{ type: "text", text: `Error: ${String(error48.cause)}` }],
+      isError: true
+    })
+  );
+}
+function createReadPasteboardTool(udid = "booted") {
+  return _x(
+    "read_pasteboard",
+    READ_PASTEBOARD_DESCRIPTION,
+    READ_PASTEBOARD_SCHEMA,
+    async () => handleReadPasteboard(udid)
+  );
+}
 var cache2 = /* @__PURE__ */ new Map();
 function parseDeviceInfo(raw) {
   const parsed = JSON.parse(raw);
@@ -64226,25 +64233,29 @@ function discoverBootedSimulators() {
 function checkIdbAvailable() {
   return runCommand("which", ["idb"]).mapErr(() => ({ type: "IDB_NOT_FOUND" }));
 }
-function createMobileIosServer(udid = "booted", extraTools = []) {
+function buildBaseTools(udid) {
+  return [
+    createScreenshotTool(udid),
+    createAccessibilitySnapshotTool(udid),
+    createTapTool(udid),
+    createDoubleTapTool(udid),
+    createLongPressTool(udid),
+    createSwipeTool(udid),
+    createTypeTextTool(udid),
+    createPressButtonTool(udid),
+    createLaunchAppTool(udid),
+    createTerminateAppTool(udid),
+    createListAppsTool(udid),
+    createWaitSecondsTool()
+  ];
+}
+function createMobileIosServer(udid = "booted", options2 = {}) {
+  const { extraTools = [], enableReadPasteboard = false } = options2;
+  const pasteboardTools = enableReadPasteboard ? [createReadPasteboardTool(udid)] : [];
   return xx({
     name: "mobile-ios",
     version: "0.0.0",
-    tools: [
-      createScreenshotTool(udid),
-      createAccessibilitySnapshotTool(udid),
-      createTapTool(udid),
-      createDoubleTapTool(udid),
-      createLongPressTool(udid),
-      createSwipeTool(udid),
-      createTypeTextTool(udid),
-      createPressButtonTool(udid),
-      createLaunchAppTool(udid),
-      createTerminateAppTool(udid),
-      createListAppsTool(udid),
-      createWaitSecondsTool(),
-      ...extraTools
-    ]
+    tools: [...buildBaseTools(udid), ...pasteboardTools, ...extraTools]
   });
 }
 
@@ -67636,7 +67647,7 @@ var analyserConfigSchema = agentBaseConfigSchema.extend({ enabled: external_expo
 
 // ../../packages/pipeline/dist/index.js
 var import_neverthrow40 = __toESM(require_index_cjs(), 1);
-var import_promises20 = require("node:timers/promises");
+var import_promises19 = require("node:timers/promises");
 
 // ../../agents/consolidator/dist/index.js
 var import_neverthrow19 = __toESM(require_index_cjs(), 1);
@@ -73783,7 +73794,7 @@ var consolidatorConfigSchema = agentBaseConfigSchema.extend({ enabled: external_
 // ../../packages/pipeline/dist/index.js
 var import_neverthrow41 = __toESM(require_index_cjs(), 1);
 var import_neverthrow42 = __toESM(require_index_cjs(), 1);
-var import_promises21 = require("node:timers/promises");
+var import_promises20 = require("node:timers/promises");
 
 // ../../agents/explorer/dist/index.js
 var import_neverthrow22 = __toESM(require_index_cjs(), 1);
@@ -73800,16 +73811,14 @@ var import_neverthrow26 = __toESM(require_index_cjs(), 1);
 var import_node_child_process3 = require("node:child_process");
 var import_promises15 = require("node:fs/promises");
 var import_neverthrow27 = __toESM(require_index_cjs(), 1);
-var import_promises16 = require("node:fs/promises");
-var import_node_path10 = __toESM(require("node:path"), 1);
 var import_neverthrow28 = __toESM(require_index_cjs(), 1);
 var import_node_child_process4 = require("node:child_process");
 var import_node_fs2 = require("node:fs");
-var import_node_path11 = __toESM(require("node:path"), 1);
+var import_node_path10 = __toESM(require("node:path"), 1);
 var import_neverthrow29 = __toESM(require_index_cjs(), 1);
 var import_neverthrow30 = __toESM(require_index_cjs(), 1);
-var import_promises17 = require("node:fs/promises");
-var import_node_path12 = __toESM(require("node:path"), 1);
+var import_promises16 = require("node:fs/promises");
+var import_node_path11 = __toESM(require("node:path"), 1);
 var import_neverthrow31 = __toESM(require_index_cjs(), 1);
 var INTERRUPT_DRAIN_TIMEOUT_MS = 1e4;
 async function interruptOrTimeout(queryRunner) {
@@ -74446,8 +74455,12 @@ function buildReportFindingTool(config2, state) {
 }
 function buildMobileIosServer(config2, state) {
   const reportFindingTool = buildReportFindingTool(config2, state);
+  const enableReadPasteboard = config2.capabilities.readPasteboard;
   if (!config2.capabilities.viewUiServer) {
-    return createMobileIosServer(config2.udid ?? "booted", [reportFindingTool]);
+    return createMobileIosServer(config2.udid ?? "booted", {
+      extraTools: [reportFindingTool],
+      enableReadPasteboard
+    });
   }
   const viewUiTool = createViewUiTool({
     udid: config2.udid,
@@ -74456,15 +74469,23 @@ function buildMobileIosServer(config2, state) {
     onEvent: config2.onEvent,
     screenshotsDir: config2.screenshotsDir
   });
-  return createMobileIosServer(config2.udid ?? "booted", [viewUiTool, reportFindingTool]);
+  return createMobileIosServer(config2.udid ?? "booted", {
+    extraTools: [viewUiTool, reportFindingTool],
+    enableReadPasteboard
+  });
 }
-function setupQuery(config2) {
-  const baseAllowedTools = [
+function buildAllowedTools(config2) {
+  const tools = [
     ...config2.allowedTools ?? [],
     REPORT_FINDING_TOOL_NAME,
-    WAIT_SECONDS_TOOL_NAME
+    WAIT_SECONDS_TOOL_NAME,
+    config2.capabilities.viewUiServer ? VIEW_UI_TOOL_NAME : void 0,
+    config2.capabilities.readPasteboard ? READ_PASTEBOARD_TOOL_NAME : void 0
   ];
-  const allowedTools = (config2.capabilities.viewUiServer ? [...baseAllowedTools, VIEW_UI_TOOL_NAME] : baseAllowedTools).filter((tool3) => typeof tool3 === "string");
+  return tools.filter((tool3) => typeof tool3 === "string");
+}
+function setupQuery(config2) {
+  const allowedTools = buildAllowedTools(config2);
   const inputQueue = new MessageQueue();
   const state = buildAgentState({ config: config2, inputQueue });
   const mobileIosServer = buildMobileIosServer(config2, state);
@@ -74529,14 +74550,13 @@ function runQuery(prompt, config2) {
 function collectAgentOutput(prompt, config2) {
   return runQuery(prompt, config2).mapErr((cause) => ({ type: "QUERY_FAILED", cause }));
 }
-var VIDEO_OUTPUT_FPS = 10;
 function spawnRecorder(outputPath) {
   const safeMkdirSync = (0, import_neverthrow29.fromThrowable)(import_node_fs2.mkdirSync, (cause) => cause);
   const safeSpawn2 = (0, import_neverthrow29.fromThrowable)(
     (command, arguments_) => (0, import_node_child_process4.spawn)(command, arguments_),
     (cause) => cause
   );
-  const mkdirResult = safeMkdirSync(import_node_path11.default.dirname(outputPath), { recursive: true });
+  const mkdirResult = safeMkdirSync(import_node_path10.default.dirname(outputPath), { recursive: true });
   if (mkdirResult.isErr()) {
     return mkdirResult.error;
   }
@@ -74545,7 +74565,7 @@ function spawnRecorder(outputPath) {
     "io",
     "booted",
     "recordVideo",
-    "--codec=h264",
+    "--codec=hevc",
     "--mask=ignored",
     "--force",
     outputPath
@@ -74582,17 +74602,6 @@ function waitForRecordingStart(proc) {
     (cause) => ({ type: "SPAWN_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 startRecording(outputPath) {
   const procOrError = spawnRecorder(outputPath);
   if (procOrError instanceof Error) {
@@ -74616,72 +74625,29 @@ function stopRecording(handle) {
     (cause) => ({ type: "STOP_FAILED", cause })
   );
 }
-function reencodeVideo({
-  inputPath,
-  outputPath,
-  fps
-}) {
-  const safeRunFfmpeg = (0, import_neverthrow29.fromAsyncThrowable)(
-    runFfmpeg,
-    (cause) => ({ type: "REENCODE_FAILED", cause })
-  );
-  return safeRunFfmpeg([
-    "-y",
-    "-fflags",
-    "+genpts",
-    "-i",
-    inputPath,
-    "-vf",
-    `fps=${String(fps)}`,
-    "-fps_mode",
-    "cfr",
-    "-c:v",
-    "h264_videotoolbox",
-    "-an",
-    outputPath
-  ]).map(() => outputPath);
-}
 var toRecordingError = (cause) => ({
   type: "RECORDING_FAILED",
   cause
 });
-function rawPathFor(videoPath) {
-  const extension = import_node_path10.default.extname(videoPath);
-  const base = extension.length > 0 ? videoPath.slice(0, -extension.length) : videoPath;
-  return `${base}.raw.mov`;
-}
-var safeUnlink = (0, import_neverthrow28.fromAsyncThrowable)(
-  import_promises16.unlink,
-  (cause) => ({ type: "REENCODE_FAILED", cause })
-);
-function tryUnlink(target) {
-  return safeUnlink(target).map(() => true).orElse(() => (0, import_neverthrow28.okAsync)(true));
-}
-function finalizeVideo(rawPath, videoPath) {
-  return reencodeVideo({ inputPath: rawPath, outputPath: videoPath, fps: VIDEO_OUTPUT_FPS }).mapErr(toRecordingError).andThen(() => tryUnlink(rawPath)).map(() => true);
-}
 function stopAndPropagate(handle, originalError) {
   return stopRecording(handle).mapErr(toRecordingError).andThen(() => (0, import_neverthrow28.errAsync)(originalError)).orElse(() => (0, import_neverthrow28.errAsync)(originalError));
 }
 function runWithRecording({
   handle,
-  rawPath,
-  videoPath,
   collectOutput
 }) {
   return collectOutput().orElse((error48) => stopAndPropagate(handle, error48)).andThen(
     (result) => stopRecording(handle).mapErr(toRecordingError).map(() => result)
-  ).andThen((result) => finalizeVideo(rawPath, videoPath).map(() => result));
+  );
 }
 function startAndRun(params) {
   const { videoPath, signal, collectOutput } = params;
-  const rawPath = rawPathFor(videoPath);
-  return startRecording(rawPath).mapErr(toRecordingError).andThen((handle) => {
+  return startRecording(videoPath).mapErr(toRecordingError).andThen((handle) => {
     const onAbort = () => {
       void stopRecording(handle).unwrapOr(null);
     };
     signal?.addEventListener("abort", onAbort, { once: true });
-    return runWithRecording({ handle, rawPath, videoPath, collectOutput }).map((result) => {
+    return runWithRecording({ handle, collectOutput }).map((result) => {
       signal?.removeEventListener("abort", onAbort);
       return result;
     }).mapErr((error48) => {
@@ -74804,8 +74770,8 @@ ${initialState2}` : void 0,
     WORKING_STATE_SECTION
   ].filter((section) => section !== void 0).join("\n\n");
 }
-function buildEnvSection(buildEnv2) {
-  return buildEnv2 === "dev" ? `
+function buildEnvSection(buildEnv3) {
+  return buildEnv3 === "dev" ? `
 
 ${DEV_ENVIRONMENT_SECTION}` : "";
 }
@@ -74872,9 +74838,9 @@ ${FINDING_TAXONOMY_SECTION}${environmentSection}
 ${reportingSection}`;
 }
 var FREESTYLE_TEMPLATE = (options2) => {
-  const { appContext, initialState: initialState2, buildEnv: buildEnv2, scenarioId } = options2 ?? {};
+  const { appContext, initialState: initialState2, buildEnv: buildEnv3, scenarioId } = options2 ?? {};
   const contextBlock = buildContextSections(appContext, initialState2);
-  const environmentSection = buildEnvSection(buildEnv2);
+  const environmentSection = buildEnvSection(buildEnv3);
   const reportingSection = buildReportFindingSection(scenarioId);
   return buildFreestyleBody({ contextBlock, environmentSection, reportingSection });
 };
@@ -75015,10 +74981,10 @@ function generateExplorerPrompt({
   specs,
   appContext,
   initialState: initialState2,
-  buildEnv: buildEnv2,
+  buildEnv: buildEnv3,
   scenarioId
 }) {
-  return mode === "spec" ? buildSpecModePrompt(specs, { appContext, initialState: initialState2, buildEnv: buildEnv2, scenarioId }) : FREESTYLE_TEMPLATE({ appContext, initialState: initialState2, buildEnv: buildEnv2, scenarioId });
+  return mode === "spec" ? buildSpecModePrompt(specs, { appContext, initialState: initialState2, buildEnv: buildEnv3, scenarioId }) : FREESTYLE_TEMPLATE({ appContext, initialState: initialState2, buildEnv: buildEnv3, scenarioId });
 }
 var FRONTMATTER_FENCE = "---";
 var INLINE_ASSERTION_DELIMITER = " \u2192 ";
@@ -75168,8 +75134,8 @@ function direntToSpecEntry(directory, entry) {
   if (entry.isFile() && entry.name.endsWith(".md")) {
     return [
       {
-        path: import_node_path12.default.join(directory, entry.name),
-        name: import_node_path12.default.basename(entry.name, import_node_path12.default.extname(entry.name)),
+        path: import_node_path11.default.join(directory, entry.name),
+        name: import_node_path11.default.basename(entry.name, import_node_path11.default.extname(entry.name)),
         required: true
       }
     ];
@@ -75177,7 +75143,7 @@ function direntToSpecEntry(directory, entry) {
   if (entry.isDirectory()) {
     return [
       {
-        path: import_node_path12.default.join(directory, entry.name, "spec.md"),
+        path: import_node_path11.default.join(directory, entry.name, "spec.md"),
         name: entry.name,
         required: false
       }
@@ -75187,7 +75153,7 @@ function direntToSpecEntry(directory, entry) {
 }
 function scanDirectory(directory) {
   const safeReaddir5 = (0, import_neverthrow31.fromAsyncThrowable)(
-    async () => (0, import_promises17.readdir)(directory, { withFileTypes: true }),
+    async () => (0, import_promises16.readdir)(directory, { withFileTypes: true }),
     (cause) => ({ type: "DIR_READ_FAILED", dir: directory, cause })
   );
   return safeReaddir5().orElse((error48) => isNotFound(error48.cause) ? (0, import_neverthrow31.okAsync)([]) : (0, import_neverthrow31.errAsync)(error48)).map(
@@ -75201,7 +75167,7 @@ function readEntries(entries) {
 }
 function readEntry(entry) {
   const safeReadFile7 = (0, import_neverthrow31.fromAsyncThrowable)(
-    async () => (0, import_promises17.readFile)(entry.path, "utf8"),
+    async () => (0, import_promises16.readFile)(entry.path, "utf8"),
     (cause) => ({ type: "FILE_READ_FAILED", path: entry.path, cause })
   );
   return safeReadFile7().map((content) => [{ name: entry.name, content }]).orElse((error48) => entry.required ? (0, import_neverthrow31.errAsync)(error48) : (0, import_neverthrow31.okAsync)([]));
@@ -75212,7 +75178,7 @@ function specNameFromPath(filePath) {
   if (fileName2 === "spec.md" && parts.length >= 2) {
     return parts.at(-2) ?? fileName2;
   }
-  return import_node_path12.default.basename(fileName2, import_node_path12.default.extname(fileName2));
+  return import_node_path11.default.basename(fileName2, import_node_path11.default.extname(fileName2));
 }
 function filterByNames(specs, specNames) {
   if (!specNames || specNames.length === 0) {
@@ -75221,7 +75187,7 @@ function filterByNames(specs, specNames) {
   return specs.filter((spec) => specNames.includes(spec.name));
 }
 function resolveSpecs(config2, repoRoot = process.cwd()) {
-  const source = config2.specFiles && config2.specFiles.length > 0 ? loadFromFiles(config2.specFiles) : loadFromDirectory(import_node_path12.default.join(repoRoot, "openspec", "specs"));
+  const source = config2.specFiles && config2.specFiles.length > 0 ? loadFromFiles(config2.specFiles) : loadFromDirectory(import_node_path11.default.join(repoRoot, "openspec", "specs"));
   return source.map((specs) => filterByNames(specs, config2.specNames));
 }
 var ISO_DATE_LENGTH = 10;
@@ -75340,7 +75306,8 @@ function runExplorer(config2) {
 var explorerCapabilitiesSchema = external_exports.object({
   videoRecording: external_exports.boolean().default(false),
   viewUiServer: external_exports.boolean().default(true),
-  findingScreenshots: external_exports.boolean().default(true)
+  findingScreenshots: external_exports.boolean().default(true),
+  readPasteboard: external_exports.boolean().default(false)
 }).strict();
 var DEFAULT_EXPLORER_CAPABILITIES = explorerCapabilitiesSchema.parse({});
 var explorerConfigSchema = agentBaseConfigSchema.extend({
@@ -75356,7 +75323,7 @@ var import_neverthrow43 = __toESM(require_index_cjs(), 1);
 
 // ../../agents/inspector/dist/index.js
 var import_neverthrow32 = __toESM(require_index_cjs(), 1);
-var import_promises18 = require("node:fs/promises");
+var import_promises17 = require("node:fs/promises");
 var import_neverthrow33 = __toESM(require_index_cjs(), 1);
 var import_neverthrow34 = __toESM(require_index_cjs(), 1);
 var import_neverthrow35 = __toESM(require_index_cjs(), 1);
@@ -75364,8 +75331,8 @@ var import_neverthrow36 = __toESM(require_index_cjs(), 1);
 var import_sharp2 = __toESM(require("sharp"), 1);
 var import_neverthrow37 = __toESM(require_index_cjs(), 1);
 var import_neverthrow38 = __toESM(require_index_cjs(), 1);
-var import_promises19 = require("node:fs/promises");
-var import_node_path13 = __toESM(require("node:path"), 1);
+var import_promises18 = require("node:fs/promises");
+var import_node_path12 = __toESM(require("node:path"), 1);
 
 // ../../node_modules/.pnpm/js-yaml@4.1.1/node_modules/js-yaml/dist/js-yaml.mjs
 function isNothing(subject) {
@@ -78676,7 +78643,7 @@ async function initArtboardNames({ designStore, config: config2, state }) {
 }
 function readScreenshot(screenshotPath, stepIndex) {
   return import_neverthrow33.ResultAsync.fromThrowable(
-    import_promises18.readFile,
+    import_promises17.readFile,
     (cause) => ({ type: "SCREENSHOT_READ_FAILED", stepIndex, cause })
   )(screenshotPath);
 }
@@ -78797,7 +78764,7 @@ function parseMeta(raw) {
   return {};
 }
 async function readAndParseSidecar(sidecarPath) {
-  const raw = await (0, import_promises19.readFile)(sidecarPath, "utf8");
+  const raw = await (0, import_promises18.readFile)(sidecarPath, "utf8");
   return parseMeta(raw);
 }
 function readSidecarFile(sidecarPath) {
@@ -78828,7 +78795,7 @@ var FsDesignStore = class {
   }
   listArtboards() {
     return (0, import_neverthrow39.fromAsyncThrowable)(
-      import_promises19.readdir,
+      import_promises18.readdir,
       wrapFsError
     )(this.designsDirectory).orElse((fsError) => {
       if (fsError.type === "FS_ERROR" && isEnoent(fsError.cause)) {
@@ -78840,10 +78807,10 @@ var FsDesignStore = class {
     );
   }
   getArtboard(filename) {
-    const pngPath = import_node_path13.default.join(this.designsDirectory, `${filename}.png`);
-    const sidecarPath = import_node_path13.default.join(this.designsDirectory, `${filename}.meta.yaml`);
+    const pngPath = import_node_path12.default.join(this.designsDirectory, `${filename}.png`);
+    const sidecarPath = import_node_path12.default.join(this.designsDirectory, `${filename}.meta.yaml`);
     return (0, import_neverthrow39.fromAsyncThrowable)(
-      import_promises19.readFile,
+      import_promises18.readFile,
       wrapFsError
     )(pngPath).orElse((fsError) => {
       if (fsError.type === "FS_ERROR" && isEnoent(fsError.cause)) {
@@ -78922,7 +78889,7 @@ function runAnalyserWithRetry(params) {
     ),
     {
       config: { maxAttempts: RETRY_MAX_ATTEMPTS, baseDelayMs: RETRY_BASE_DELAY_MS },
-      delayFunction: import_promises20.setTimeout,
+      delayFunction: import_promises19.setTimeout,
       onRetry: ({ attempt, maxAttempts, delayMs, error: error48 }) => {
         onEvent?.({
           type: "AGENT_RETRY",
@@ -79083,7 +79050,7 @@ function runExplorerWithRetry(options2) {
   const { explorerConfig, udid, onEvent } = options2;
   return withRetry(() => runExplorerWithTeardown(explorerConfig, udid), {
     config: { maxAttempts: RETRY_MAX_ATTEMPTS, baseDelayMs: RETRY_BASE_DELAY_MS },
-    delayFunction: import_promises21.setTimeout,
+    delayFunction: import_promises20.setTimeout,
     onRetry: ({ attempt, maxAttempts, delayMs, error: error48 }) => {
       onEvent?.({
         type: "AGENT_RETRY",
@@ -79836,16 +79803,16 @@ function parseVerboseOption(value) {
 
 // src/shell/xqa-directory.ts
 var import_node_fs6 = require("node:fs");
-var import_node_path14 = __toESM(require("node:path"), 1);
+var import_node_path13 = __toESM(require("node:path"), 1);
 var import_neverthrow51 = __toESM(require_index_cjs(), 1);
 function findXqaDirectory(startDirectory) {
   let current = startDirectory;
   for (; ; ) {
-    const candidate = import_node_path14.default.join(current, ".xqa");
+    const candidate = import_node_path13.default.join(current, ".xqa");
     if ((0, import_node_fs6.existsSync)(candidate)) {
       return (0, import_neverthrow51.ok)(candidate);
     }
-    const parent = import_node_path14.default.dirname(current);
+    const parent = import_node_path13.default.dirname(current);
     if (parent === current) {
       return (0, import_neverthrow51.err)({ type: "XQA_NOT_INITIALIZED" });
     }
@@ -79864,7 +79831,7 @@ function resolveXqaDirectory() {
 }
 
 // src/commands/explore/pipeline-config.ts
-var import_node_path15 = __toESM(require("node:path"), 1);
+var import_node_path14 = __toESM(require("node:path"), 1);
 function resolveTimeoutMs({
   input,
   rootConfig
@@ -79919,7 +79886,7 @@ function buildPipelineConfig({
   simulatorUdid
 }) {
   const base = {
-    outputDir: import_node_path15.default.join(xqaDirectory, "output"),
+    outputDir: import_node_path14.default.join(xqaDirectory, "output"),
     runId: rootConfig.run.id,
     simulatorUdid,
     onEvent,
@@ -79932,7 +79899,7 @@ function buildPipelineConfig({
 
 // src/core/last-path.ts
 var import_node_fs7 = require("node:fs");
-var import_node_path16 = __toESM(require("node:path"), 1);
+var import_node_path15 = __toESM(require("node:path"), 1);
 var import_neverthrow52 = __toESM(require_index_cjs(), 1);
 function resolveLastPath(argument, stateContent) {
   if (argument !== void 0) {
@@ -79945,7 +79912,7 @@ function resolveLastPath(argument, stateContent) {
   return (0, import_neverthrow52.err)({ type: "NO_ARG_AND_NO_STATE" });
 }
 function lastPathFilePath(xqaDirectoryectory) {
-  return import_node_path16.default.join(xqaDirectoryectory, "last-findings-path");
+  return import_node_path15.default.join(xqaDirectoryectory, "last-findings-path");
 }
 function writeLastPath(xqaDirectory, findingsPath) {
   (0, import_node_fs7.writeFileSync)(lastPathFilePath(xqaDirectory), findingsPath);
@@ -80065,8 +80032,8 @@ function buildExploreRunState({
 }
 
 // src/shell/app-context.ts
-var import_promises22 = require("node:fs/promises");
-var import_node_path17 = __toESM(require("node:path"), 1);
+var import_promises21 = require("node:fs/promises");
+var import_node_path16 = __toESM(require("node:path"), 1);
 var import_neverthrow55 = __toESM(require_index_cjs(), 1);
 var HTML_COMMENT_PATTERN = /<!--[\s\S]*?-->/g;
 function isEnoentError(value) {
@@ -80080,7 +80047,7 @@ function absentContext() {
   return (0, import_neverthrow55.ok)(absent);
 }
 var safeReadFile2 = import_neverthrow55.ResultAsync.fromThrowable(
-  async (filePath) => (0, import_promises22.readFile)(filePath, "utf8"),
+  async (filePath) => (0, import_promises21.readFile)(filePath, "utf8"),
   toAppContextError
 );
 function stripAndNormalize(content) {
@@ -80088,7 +80055,7 @@ function stripAndNormalize(content) {
   return stripped.length === 0 ? void 0 : stripped;
 }
 function readContextFile(xqaDirectory, filename) {
-  const filePath = import_node_path17.default.join(xqaDirectory, filename);
+  const filePath = import_node_path16.default.join(xqaDirectory, filename);
   return safeReadFile2(filePath).map((content) => stripAndNormalize(content)).orElse((error48) => {
     if (isEnoentError(error48.cause)) {
       return absentContext();
@@ -80233,21 +80200,21 @@ function registerExploreCommand(program3, loader2) {
 
 // src/commands/init-command.ts
 var import_node_fs9 = require("node:fs");
-var import_node_path19 = __toESM(require("node:path"), 1);
+var import_node_path18 = __toESM(require("node:path"), 1);
 
 // src/commands/install-skills.ts
 var import_node_child_process5 = require("node:child_process");
 var import_node_fs8 = require("node:fs");
-var import_node_path18 = __toESM(require("node:path"), 1);
+var import_node_path17 = __toESM(require("node:path"), 1);
 var import_node_url = require("node:url");
 function resolveSkillsRoot() {
-  const packageDistributionDirectory = import_node_path18.default.dirname((0, import_node_url.fileURLToPath)(__importMetaUrl));
-  return import_node_path18.default.join(packageDistributionDirectory, "skills");
+  const packageDistributionDirectory = import_node_path17.default.dirname((0, import_node_url.fileURLToPath)(__importMetaUrl));
+  return import_node_path17.default.join(packageDistributionDirectory, "skills");
 }
 function installSkills() {
   const skillsRoot = resolveSkillsRoot();
   for (const skill of (0, import_node_fs8.readdirSync)(skillsRoot)) {
-    (0, import_node_child_process5.spawnSync)("npx", ["skills", "add", import_node_path18.default.join(skillsRoot, skill), "-y"], {
+    (0, import_node_child_process5.spawnSync)("npx", ["skills", "add", import_node_path17.default.join(skillsRoot, skill), "-y"], {
       stdio: "inherit"
     });
   }
@@ -80259,7 +80226,7 @@ var GITIGNORE_CONTENT = `/output
 `;
 var TEST_PLAN_IGNORE_LINE = ".xqa/test-plan/";
 function ensureTestPlanIgnored(repoRoot) {
-  const gitignorePath = import_node_path19.default.join(repoRoot, ".gitignore");
+  const gitignorePath = import_node_path18.default.join(repoRoot, ".gitignore");
   if (!(0, import_node_fs9.existsSync)(gitignorePath)) {
     (0, import_node_fs9.writeFileSync)(gitignorePath, `${TEST_PLAN_IGNORE_LINE}
 `);
@@ -80316,12 +80283,12 @@ Scope applies from the starting screen. If the focus area requires navigation, d
 `;
 function scaffoldProject(xqaDirectory) {
   (0, import_node_fs9.mkdirSync)(xqaDirectory);
-  (0, import_node_fs9.writeFileSync)(import_node_path19.default.join(xqaDirectory, ".gitignore"), GITIGNORE_CONTENT);
-  (0, import_node_fs9.writeFileSync)(import_node_path19.default.join(xqaDirectory, "app.md"), APP_TEMPLATE);
-  (0, import_node_fs9.writeFileSync)(import_node_path19.default.join(xqaDirectory, "explore.md"), EXPLORE_TEMPLATE);
+  (0, import_node_fs9.writeFileSync)(import_node_path18.default.join(xqaDirectory, ".gitignore"), GITIGNORE_CONTENT);
+  (0, import_node_fs9.writeFileSync)(import_node_path18.default.join(xqaDirectory, "app.md"), APP_TEMPLATE);
+  (0, import_node_fs9.writeFileSync)(import_node_path18.default.join(xqaDirectory, "explore.md"), EXPLORE_TEMPLATE);
   for (const subdir of ["designs", "specs", "suites"]) {
-    (0, import_node_fs9.mkdirSync)(import_node_path19.default.join(xqaDirectory, subdir));
-    (0, import_node_fs9.writeFileSync)(import_node_path19.default.join(xqaDirectory, subdir, ".gitkeep"), "");
+    (0, import_node_fs9.mkdirSync)(import_node_path18.default.join(xqaDirectory, subdir));
+    (0, import_node_fs9.writeFileSync)(import_node_path18.default.join(xqaDirectory, subdir, ".gitkeep"), "");
   }
 }
 function printInitReport(report) {
@@ -80343,7 +80310,7 @@ ${addedLines}
 }
 async function runInitCommand() {
   const cwd = process.cwd();
-  const xqaDirectory = import_node_path19.default.join(cwd, ".xqa");
+  const xqaDirectory = import_node_path18.default.join(cwd, ".xqa");
   installSkills();
   ensureTestPlanIgnored(cwd);
   if ((0, import_node_fs9.existsSync)(xqaDirectory)) {
@@ -80370,7 +80337,7 @@ function registerInitCommand(program3) {
 }
 
 // src/commands/plan/edit-command.ts
-var import_node_path24 = __toESM(require("node:path"), 1);
+var import_node_path23 = __toESM(require("node:path"), 1);
 
 // ../../agents/planner/dist/index.js
 var import_neverthrow56 = __toESM(require_index_cjs(), 1);
@@ -80380,26 +80347,29 @@ var yaml2 = __toESM(require_dist(), 1);
 var import_neverthrow59 = __toESM(require_index_cjs(), 1);
 var yaml22 = __toESM(require_dist(), 1);
 var import_neverthrow60 = __toESM(require_index_cjs(), 1);
-var import_promises23 = require("node:fs/promises");
-var import_node_path20 = __toESM(require("node:path"), 1);
+var import_promises22 = require("node:fs/promises");
+var import_node_path19 = __toESM(require("node:path"), 1);
 var import_neverthrow61 = __toESM(require_index_cjs(), 1);
-var import_promises24 = require("node:fs/promises");
+var import_promises23 = require("node:fs/promises");
 var import_neverthrow62 = __toESM(require_index_cjs(), 1);
 var import_neverthrow63 = __toESM(require_index_cjs(), 1);
 var import_node_child_process6 = require("node:child_process");
 var import_node_util = require("node:util");
 var import_neverthrow64 = __toESM(require_index_cjs(), 1);
 var import_node_process2 = require("node:process");
+var import_node_child_process7 = require("node:child_process");
+var import_node_util2 = require("node:util");
 var import_neverthrow65 = __toESM(require_index_cjs(), 1);
 var import_neverthrow66 = __toESM(require_index_cjs(), 1);
-var import_promises25 = require("node:fs/promises");
-var import_node_path21 = __toESM(require("node:path"), 1);
 var import_neverthrow67 = __toESM(require_index_cjs(), 1);
-var import_promises26 = require("node:fs/promises");
-var import_node_path22 = __toESM(require("node:path"), 1);
+var import_promises24 = require("node:fs/promises");
+var import_node_path20 = __toESM(require("node:path"), 1);
 var import_neverthrow68 = __toESM(require_index_cjs(), 1);
-var import_promises27 = require("node:fs/promises");
+var import_promises25 = require("node:fs/promises");
+var import_node_path21 = __toESM(require("node:path"), 1);
 var import_neverthrow69 = __toESM(require_index_cjs(), 1);
+var import_promises26 = require("node:fs/promises");
+var import_neverthrow70 = __toESM(require_index_cjs(), 1);
 function isEmptySummary(summary) {
   return summary.touchedFiles.length === 0 && summary.uncommittedFiles.length === 0;
 }
@@ -80677,6 +80647,25 @@ function classifyActionability(summary, rawDiff) {
   }
   return { kind: "actionable" };
 }
+function summarizeChangeSummary(summary) {
+  const hints = summary.hints.length > 0 ? summary.hints.join(",") : "none";
+  return [
+    `files=${String(summary.touchedFiles.length)}`,
+    `uncommitted=${String(summary.uncommittedFiles.length)}`,
+    `+${String(summary.addedLines)}/-${String(summary.deletedLines)}`,
+    `hints=${hints}`
+  ].join(" ");
+}
+function emitClassificationDebug(input) {
+  if (input.emitDebug === void 0) {
+    return;
+  }
+  if (input.kind === "empty") {
+    input.emitDebug(`[plan] classification=empty reason=${input.reason ?? "unknown"}`);
+    return;
+  }
+  input.emitDebug("[plan] classification=actionable");
+}
 var PORCELAIN_PATH_OFFSET = 3;
 var PORCELAIN_RENAME_SEPARATOR = " -> ";
 function extractPorcelainPath(line) {
@@ -80697,7 +80686,10 @@ function branchReferenceToString(reference) {
   return reference.sha;
 }
 function resolveBaseReference(context) {
-  return context.deps.gitSymbolicReferenceOriginHead(context.input.gitContext);
+  if (context.input.baseOverride !== void 0) {
+    return (0, import_neverthrow56.okAsync)(context.input.baseOverride);
+  }
+  return context.deps.resolveBaseBranch(context.input.gitContext);
 }
 function assertNonEmptyDiff(state) {
   if (isEmptySummary(state.summary)) {
@@ -80707,15 +80699,16 @@ function assertNonEmptyDiff(state) {
 }
 function emitDrafts(input) {
   const { context, summary } = input;
-  return recoverPlanMissing(context.deps.readPlan({ directory: context.input.outputDirectory })).map((entries) => toSpecSummaries(entries)).andThen(
-    (existingSpecs) => context.deps.emitScenarios({
+  return recoverPlanMissing(context.deps.readPlan({ directory: context.input.outputDirectory })).map((entries) => toSpecSummaries(entries)).andThen((existingSpecs) => {
+    context.deps.emitDebug?.(`[plan] existing-specs count=${String(existingSpecs.length)}`);
+    return context.deps.emitScenarios({
       summary,
       intent: context.input.intent,
       appContext: context.input.appContext,
       existingSpecs,
       aiConfig: context.input.aiConfig
-    })
-  );
+    });
+  });
 }
 function persistScenarios(input) {
   return input.context.deps.writeScenarios({
@@ -80732,6 +80725,7 @@ function persistScenarios(input) {
 function runEmitAndPersist(input) {
   const { state, context } = input;
   return emitDrafts({ summary: state.summary, context }).andThen((drafts) => {
+    context.deps.emitDebug?.(`[plan] drafts count=${String(drafts.length)}`);
     if (drafts.length === 0) {
       return (0, import_neverthrow56.okAsync)({
         specs: [],
@@ -80745,9 +80739,12 @@ function runEmitAndPersist(input) {
 }
 function dispatchClassification(input) {
   const classification = classifyActionability(input.state.summary, input.state.rawDiff);
+  const emitDebug = input.context.deps.emitDebug;
   if (classification.kind === "empty") {
+    emitClassificationDebug({ emitDebug, kind: "empty", reason: classification.reason });
     return (0, import_neverthrow56.okAsync)({ specs: [], emptyReason: classification.reason });
   }
+  emitClassificationDebug({ emitDebug, kind: "actionable" });
   return runEmitAndPersist(input);
 }
 function combineReferences(context) {
@@ -80755,7 +80752,10 @@ function combineReferences(context) {
     (baseReference) => resolveHead({
       gitContext: context.input.gitContext,
       gitBranchReference: context.deps.gitBranchReference
-    }).map((head) => ({ baseRef: baseReference, head }))
+    }).map((head) => {
+      context.deps.emitDebug?.(`[plan] base=${baseReference} head=${head}`);
+      return { baseRef: baseReference, head };
+    })
   );
 }
 function buildSummaryState(context, references) {
@@ -80764,11 +80764,16 @@ function buildSummaryState(context, references) {
     gitContext: context.input.gitContext,
     gitDiff: context.deps.gitDiff,
     gitStatusPorcelain: context.deps.gitStatusPorcelain
-  }).map((collected) => ({
-    ...references,
-    rawDiff: collected.rawDiff,
-    summary: collected.summary
-  }));
+  }).map((collected) => {
+    context.deps.emitDebug?.(
+      `[plan] diff-bytes=${String(collected.rawDiff.length)} ${summarizeChangeSummary(collected.summary)}`
+    );
+    return {
+      ...references,
+      rawDiff: collected.rawDiff,
+      summary: collected.summary
+    };
+  });
 }
 function resolveHead(input) {
   return input.gitBranchReference(input.gitContext).map((reference) => branchReferenceToString(reference));
@@ -81252,8 +81257,8 @@ function extendPlan(input, deps) {
 }
 async function writeAndRename(input) {
   const temporaryPath = `${input.path}.tmp`;
-  await (0, import_promises24.writeFile)(temporaryPath, input.content, "utf8");
-  await (0, import_promises24.rename)(temporaryPath, input.path);
+  await (0, import_promises23.writeFile)(temporaryPath, input.content, "utf8");
+  await (0, import_promises23.rename)(temporaryPath, input.path);
 }
 var rawAtomicWrite = import_neverthrow62.ResultAsync.fromThrowable(
   writeAndRename,
@@ -81415,7 +81420,7 @@ function validateFindings(input) {
   return parseFindingsJson(input).andThen((data) => validateFindingsSchema(data, input.path));
 }
 function reportPathFor(findingsPath) {
-  return import_node_path20.default.join(import_node_path20.default.dirname(findingsPath), REPORT_FILENAME);
+  return import_node_path19.default.join(import_node_path19.default.dirname(findingsPath), REPORT_FILENAME);
 }
 function buildReport(input) {
   return correlate({
@@ -81437,7 +81442,7 @@ function correlateAndPersist(input) {
   });
 }
 var rawReadFindings = import_neverthrow61.ResultAsync.fromThrowable(
-  async (filePath) => (0, import_promises23.readFile)(filePath, "utf8"),
+  async (filePath) => (0, import_promises22.readFile)(filePath, "utf8"),
   (cause) => ({ cause })
 );
 function readFindingsFile(filePath) {
@@ -81585,6 +81590,48 @@ function gitStatusPorcelain(context) {
 function gitSymbolicReferenceOriginHead(context) {
   return execGit(["symbolic-ref", "--short", "refs/remotes/origin/HEAD"], context).map((result) => stripOriginPrefix(result.stdout)).mapErr(() => ({ type: "GIT_NO_BASE_BRANCH" }));
 }
+var NON_INTERACTIVE_ENV = {
+  PAGER: "",
+  GH_PAGER: "",
+  GH_FORCE_TTY: "",
+  GH_PROMPT_DISABLED: "1"
+};
+var execFileAsync2 = (0, import_node_util2.promisify)(
+  import_node_child_process7.execFile
+);
+function buildEnv2(context) {
+  return {
+    ...readProcessEnv(),
+    ...NON_INTERACTIVE_ENV,
+    ...context.env
+  };
+}
+async function runGh(input) {
+  const { stdout, stderr } = await execFileAsync2("gh", [...input.commandArguments], {
+    cwd: input.context.cwd,
+    env: buildEnv2(input.context)
+  });
+  return { stdout, stderr };
+}
+var safeRunGh = (0, import_neverthrow65.fromAsyncThrowable)(
+  runGh,
+  (cause) => ({ type: "GH_PR_LOOKUP_FAILED", cause })
+);
+function ghDetectPrBaseBranch(context) {
+  return safeRunGh({
+    commandArguments: ["pr", "view", "--json", "baseRefName", "-q", ".baseRefName"],
+    context
+  }).andThen((result) => {
+    const value = result.stdout.trim();
+    if (value.length === 0) {
+      return (0, import_neverthrow65.errAsync)({ type: "GH_PR_LOOKUP_FAILED", cause: "empty-output" });
+    }
+    return (0, import_neverthrow65.okAsync)(value);
+  });
+}
+function resolveBaseBranch(gitContext, deps) {
+  return deps.ghDetectPrBaseBranch(gitContext).orElse(() => deps.gitSymbolicReferenceOriginHead(gitContext));
+}
 var MAX_EXISTING_SPECS = 30;
 function renderList(items, emptyLabel) {
   if (items.length === 0) {
@@ -81702,20 +81749,20 @@ var scenarioDraftSchema = external_exports.object({
   coverageNote: external_exports.string().optional()
 });
 var payloadSchema = external_exports.object({ scenarios: external_exports.array(scenarioDraftSchema) });
-var safeParseJson3 = (0, import_neverthrow65.fromThrowable)(
+var safeParseJson3 = (0, import_neverthrow66.fromThrowable)(
   (raw) => JSON.parse(raw),
   () => ({ type: "AI_RESPONSE_JSON_PARSE" })
 );
 function validatePayload(raw) {
   const parsed = safeParseJson3(raw);
   if (parsed.isErr()) {
-    return (0, import_neverthrow65.err)({ type: "AI_RESPONSE_INVALID", operation: "scenario-emit", raw });
+    return (0, import_neverthrow66.err)({ type: "AI_RESPONSE_INVALID", operation: "scenario-emit", raw });
   }
   const validated = payloadSchema.safeParse(parsed.value);
   if (!validated.success) {
-    return (0, import_neverthrow65.err)({ type: "AI_RESPONSE_INVALID", operation: "scenario-emit", raw });
+    return (0, import_neverthrow66.err)({ type: "AI_RESPONSE_INVALID", operation: "scenario-emit", raw });
   }
-  return (0, import_neverthrow65.ok)(validated.data.scenarios);
+  return (0, import_neverthrow66.ok)(validated.data.scenarios);
 }
 function emitScenarios(input, deps) {
   const prompt = buildScenarioEmitterPrompt({
@@ -81724,7 +81771,13 @@ function emitScenarios(input, deps) {
     appContext: input.appContext,
     existingSpecs: input.existingSpecs
   });
-  return deps.callAi({ prompt, config: input.aiConfig }).andThen((raw) => validatePayload(raw));
+  deps.emitDebug?.(`[plan] prompt chars=${String(prompt.length)}
+${prompt}`);
+  return deps.callAi({ prompt, config: input.aiConfig }).andThen((raw) => {
+    deps.emitDebug?.(`[plan] ai-response chars=${String(raw.length)}
+${raw}`);
+    return validatePayload(raw);
+  });
 }
 function renderExistingSpecSection(existingSpec) {
   const feature = existingSpec.feature;
@@ -81791,14 +81844,14 @@ function validateCandidate(validateInput) {
   const { raw, existingSpec, specPath } = validateInput;
   const parsed = parseSpec(raw, specPath);
   if (parsed.isErr()) {
-    return (0, import_neverthrow66.err)({ type: "AI_RESPONSE_INVALID", operation: "edit-apply", raw });
+    return (0, import_neverthrow67.err)({ type: "AI_RESPONSE_INVALID", operation: "edit-apply", raw });
   }
   const candidate = parsed.value;
   const violated = findMissingOrChangedKey(candidate, existingSpec);
   if (violated !== void 0) {
-    return (0, import_neverthrow66.err)({ type: "SCENARIO_ID_LOST_IN_EDIT", path: specPath });
+    return (0, import_neverthrow67.err)({ type: "SCENARIO_ID_LOST_IN_EDIT", path: specPath });
   }
-  return (0, import_neverthrow66.ok)(candidate);
+  return (0, import_neverthrow67.ok)(candidate);
 }
 function applyEdit(input, deps) {
   const prompt = buildEditApplierPrompt(input.existingSpec, input.userFeedback);
@@ -81816,15 +81869,15 @@ function mapReaddirError(input) {
   }
   return { type: "SPEC_READ_FAILED", path: input.directory, cause: input.cause };
 }
-var rawReaddir = import_neverthrow67.ResultAsync.fromThrowable(
-  async (directory) => (0, import_promises25.readdir)(directory),
+var rawReaddir = import_neverthrow68.ResultAsync.fromThrowable(
+  async (directory) => (0, import_promises24.readdir)(directory),
   (cause) => ({ cause })
 );
 function safeReaddir(directory) {
   return rawReaddir(directory).mapErr(({ cause }) => mapReaddirError({ directory, cause }));
 }
-var rawReadFile = import_neverthrow67.ResultAsync.fromThrowable(
-  async (input) => (0, import_promises25.readFile)(input.path, "utf8"),
+var rawReadFile = import_neverthrow68.ResultAsync.fromThrowable(
+  async (input) => (0, import_promises24.readFile)(input.path, "utf8"),
   (cause) => ({ cause })
 );
 function safeReadFile3(input) {
@@ -81836,25 +81889,25 @@ function filterAndSortSpecs(filenames) {
   return filenames.filter((name) => name.endsWith(SPEC_SUFFIX)).toSorted();
 }
 function readEntry2(input) {
-  const entryPath = import_node_path21.default.join(input.directory, input.filename);
+  const entryPath = import_node_path20.default.join(input.directory, input.filename);
   return safeReadFile3({ path: entryPath }).andThen(
     (raw) => parseSpec(raw, entryPath).map((spec) => ({ path: entryPath, spec }))
   );
 }
 function readEntries2(directory, filenames) {
   const tasks = filenames.map((filename) => readEntry2({ directory, filename }));
-  return import_neverthrow67.ResultAsync.combine([...tasks]);
+  return import_neverthrow68.ResultAsync.combine([...tasks]);
 }
 function readPlan(input) {
   return safeReaddir(input.directory).map((filenames) => filterAndSortSpecs(filenames)).andThen((filenames) => readEntries2(input.directory, filenames));
 }
 var SCENARIO_FILENAME_PATTERN = /^scenario-(\d+)\.test\.md$/;
-var safeMkdir = import_neverthrow68.ResultAsync.fromThrowable(
-  async (path43) => (0, import_promises26.mkdir)(path43, { recursive: true }),
+var safeMkdir = import_neverthrow69.ResultAsync.fromThrowable(
+  async (path43) => (0, import_promises25.mkdir)(path43, { recursive: true }),
   (cause) => ({ type: "SPEC_WRITE_FAILED", path: "", cause })
 );
-var safeReaddir2 = import_neverthrow68.ResultAsync.fromThrowable(
-  async (path43) => (0, import_promises26.readdir)(path43),
+var safeReaddir2 = import_neverthrow69.ResultAsync.fromThrowable(
+  async (path43) => (0, import_promises25.readdir)(path43),
   (cause) => ({ type: "SPEC_WRITE_FAILED", path: "", cause })
 );
 function ensureDirectory(directory) {
@@ -81890,7 +81943,7 @@ function buildMeta(context) {
 }
 function writeSingleScenario(input) {
   const filename = `scenario-${String(input.index)}.test.md`;
-  const targetPath = import_node_path22.default.join(input.directory, filename);
+  const targetPath = import_node_path21.default.join(input.directory, filename);
   const meta3 = buildMeta(input.context);
   const content = renderSpec2(input.draft, meta3);
   return atomicWrite({ path: targetPath, content }).map(() => targetPath);
@@ -81904,13 +81957,13 @@ function writeAllScenarios(input, startIndex) {
       context: input.context
     })
   );
-  return import_neverthrow68.ResultAsync.combine([...tasks]);
+  return import_neverthrow69.ResultAsync.combine([...tasks]);
 }
 function writeScenarios(input) {
   return ensureDirectory(input.directory).andThen(() => listScenarioIndices(input.directory)).map((indices) => computeNextIndex(indices)).andThen((startIndex) => writeAllScenarios(input, startIndex));
 }
-var readFileByPath = import_neverthrow69.ResultAsync.fromThrowable(
-  async (path43) => (0, import_promises27.readFile)(path43, "utf8"),
+var readFileByPath = import_neverthrow70.ResultAsync.fromThrowable(
+  async (path43) => (0, import_promises26.readFile)(path43, "utf8"),
   (cause) => ({ cause })
 );
 function readSpecFile(path43) {
@@ -81923,7 +81976,7 @@ function writeSpecFile(input) {
 }
 
 // src/commands/plan/shared-runner.ts
-var import_node_path23 = __toESM(require("node:path"), 1);
+var import_node_path22 = __toESM(require("node:path"), 1);
 
 // src/commands/plan/exit-codes.ts
 var EXIT_OK = 0;
@@ -81945,10 +81998,10 @@ var EXIT_PLAN_EMPTY = 45;
 var EXIT_SCENARIO_ID_LOST_IN_EDIT = 51;
 
 // src/commands/plan/format-diagnostic.ts
-var import_neverthrow70 = __toESM(require_index_cjs(), 1);
+var import_neverthrow71 = __toESM(require_index_cjs(), 1);
 var RAW_TRUNCATION_LIMIT = 200;
 var UNSERIALIZABLE2 = "[unserializable]";
-var safeStringify2 = (0, import_neverthrow70.fromThrowable)(
+var safeStringify2 = (0, import_neverthrow71.fromThrowable)(
   (value) => JSON.stringify(value),
   () => UNSERIALIZABLE2
 );
@@ -82018,9 +82071,9 @@ var PLANNER_MODEL = "claude-opus-4-5";
 var DEFAULT_PLAN_SUBDIR = "test-plan/default";
 function resolveOutputDirectory(xqaDirectory, override) {
   if (override !== void 0) {
-    return import_node_path23.default.resolve(process.cwd(), override);
+    return import_node_path22.default.resolve(process.cwd(), override);
   }
-  return import_node_path23.default.join(xqaDirectory, DEFAULT_PLAN_SUBDIR);
+  return import_node_path22.default.join(xqaDirectory, DEFAULT_PLAN_SUBDIR);
 }
 function readAppContextOrDiagnose(xqaDirectory) {
   return readAppContext(xqaDirectory).mapErr(
@@ -82046,7 +82099,7 @@ var DEPS = {
 };
 function buildPlannerInput(input, options2) {
   return {
-    file: import_node_path24.default.resolve(process.cwd(), input.file),
+    file: import_node_path23.default.resolve(process.cwd(), input.file),
     userFeedback: input.feedback,
     aiConfig: {
       apiKey: options2.config.ANTHROPIC_API_KEY,
@@ -82193,15 +82246,23 @@ function runPlanExtend(input, options2) {
 }
 
 // src/commands/plan/generate-command.ts
-var DEPS3 = {
-  gitBranchReference,
-  gitSymbolicReferenceOriginHead,
-  gitDiff,
-  gitStatusPorcelain,
-  emitScenarios: (input) => emitScenarios(input, { callAi: callScenarioEmitter }),
-  writeScenarios,
-  readPlan
-};
+function stderrDebug(message) {
+  process.stderr.write(`${message}
+`);
+}
+function buildDeps(input) {
+  const emitDebug = input.debug === true ? stderrDebug : void 0;
+  return {
+    gitBranchReference,
+    resolveBaseBranch: (gitContext) => resolveBaseBranch(gitContext, { ghDetectPrBaseBranch, gitSymbolicReferenceOriginHead }),
+    gitDiff,
+    gitStatusPorcelain,
+    emitScenarios: (emitInput) => emitScenarios(emitInput, { callAi: callScenarioEmitter, emitDebug }),
+    writeScenarios,
+    readPlan,
+    emitDebug
+  };
+}
 function buildPlannerInput3(arguments_, appContext) {
   return {
     gitContext: { cwd: process.cwd() },
@@ -82216,12 +82277,13 @@ function buildPlannerInput3(arguments_, appContext) {
       model: PLANNER_MODEL
     },
     idGenerator: () => ulid3(),
-    now: () => (/* @__PURE__ */ new Date()).toISOString()
+    now: () => (/* @__PURE__ */ new Date()).toISOString(),
+    baseOverride: arguments_.input.baseOverride
   };
 }
 function executePipeline4(arguments_) {
   return readAppContextOrDiagnose(arguments_.input.xqaDirectory).andThen(
-    (appContext) => generatePlan(buildPlannerInput3(arguments_, appContext ?? ""), DEPS3)
+    (appContext) => generatePlan(buildPlannerInput3(arguments_, appContext ?? ""), buildDeps(arguments_.input))
   );
 }
 function runPlanGenerate(input, options2) {
@@ -82229,33 +82291,39 @@ function runPlanGenerate(input, options2) {
 }
 
 // src/commands/plan/report-command.ts
-var import_node_path25 = __toESM(require("node:path"), 1);
-var DEPS4 = {
+var import_node_path24 = __toESM(require("node:path"), 1);
+var DEPS3 = {
   readPlan,
   readFindingsFile,
   writeReportFile
 };
 function buildReportInput(input) {
   return {
-    findingsPath: import_node_path25.default.resolve(process.cwd(), input.findingsPath),
+    findingsPath: import_node_path24.default.resolve(process.cwd(), input.findingsPath),
     specsDirectory: resolveOutputDirectory(input.xqaDirectory, input.specsDirectory)
   };
 }
 function executePipeline5(input) {
-  return reportRun(buildReportInput(input), DEPS4);
+  return reportRun(buildReportInput(input), DEPS3);
 }
 function runPlanReport(input) {
   void executePipeline5(input).match(emitSuccess, emitFailure);
 }
 
 // src/commands/register/plan.ts
+function normalizeBaseOverride(value) {
+  const trimmed = value?.trim();
+  return trimmed !== void 0 && trimmed.length > 0 ? trimmed : void 0;
+}
 function invokePlanGenerate(context, options2) {
   const xqaDirectory = resolveXqaDirectory();
   runPlanGenerate(
     {
       intent: options2.intent ?? "",
       outputDirectory: options2.out,
-      xqaDirectory
+      xqaDirectory,
+      baseOverride: normalizeBaseOverride(options2.base),
+      debug: options2.debug
     },
     { config: context.config }
   );
@@ -82289,7 +82357,7 @@ function registerReportSubcommand(plan) {
   });
 }
 function registerPlanCommand(program3, loader2) {
-  const plan = program3.command("plan").description("Generate or evolve the manual test plan for the current branch").option("--intent <text>", "Optional focus hint for the planner", "").option("--out <dir>", "Output directory for the generated scenarios").action((options2) => {
+  const plan = program3.command("plan").description("Generate or evolve the manual test plan for the current branch").option("--intent <text>", "Optional focus hint for the planner", "").option("--out <dir>", "Output directory for the generated scenarios").option("--base <ref>", "Base git ref to diff against (defaults to origin/HEAD)").option("--debug", "Log base ref, diff summary, prompt, and AI response to stderr").action((options2) => {
     const context = resolveContextOrExit(loader2);
     invokePlanGenerate(context, options2);
   });
@@ -82300,8 +82368,8 @@ function registerPlanCommand(program3, loader2) {
 
 // src/commands/review-command.ts
 var import_node_fs10 = require("node:fs");
-var import_node_path27 = __toESM(require("node:path"), 1);
-var import_neverthrow72 = __toESM(require_index_cjs(), 1);
+var import_node_path26 = __toESM(require("node:path"), 1);
+var import_neverthrow73 = __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 = []) => (
@@ -83252,7 +83320,7 @@ var {
 } = signalExitWrap(processOk(process5) ? new SignalExit(process5) : new SignalExitFallback());
 
 // ../../node_modules/.pnpm/@inquirer+core@10.3.2_@types+node@22.19.15/node_modules/@inquirer/core/dist/esm/lib/screen-manager.js
-var import_node_util2 = require("node:util");
+var import_node_util3 = require("node:util");
 
 // ../../node_modules/.pnpm/@inquirer+ansi@1.0.2/node_modules/@inquirer/ansi/dist/esm/index.js
 var ESC2 = "\x1B[";
@@ -83290,7 +83358,7 @@ var ScreenManager = class {
   }
   render(content, bottomContent = "") {
     const promptLine = lastLine(content);
-    const rawPromptLine = (0, import_node_util2.stripVTControlCharacters)(promptLine);
+    const rawPromptLine = (0, import_node_util3.stripVTControlCharacters)(promptLine);
     let prompt = rawPromptLine;
     if (this.rl.line.length > 0) {
       prompt = prompt.slice(0, -this.rl.line.length);
@@ -83639,7 +83707,7 @@ var esm_default2 = createPrompt((config2, done) => {
 var import_chardet = __toESM(require_lib2(), 1);
 var import_child_process3 = require("child_process");
 var import_fs3 = require("fs");
-var import_node_path26 = __toESM(require("node:path"), 1);
+var import_node_path25 = __toESM(require("node:path"), 1);
 var import_node_os3 = __toESM(require("node:os"), 1);
 var import_node_crypto3 = require("node:crypto");
 var import_iconv_lite = __toESM(require_lib3(), 1);
@@ -83775,8 +83843,8 @@ var ExternalEditor = class {
       const prefix = sanitizeAffix(this.fileOptions.prefix);
       const postfix = sanitizeAffix(this.fileOptions.postfix);
       const filename = `${prefix}${id}${postfix}`;
-      const candidate = import_node_path26.default.resolve(baseDir, filename);
-      const baseResolved = import_node_path26.default.resolve(baseDir) + import_node_path26.default.sep;
+      const candidate = import_node_path25.default.resolve(baseDir, filename);
+      const baseResolved = import_node_path25.default.resolve(baseDir) + import_node_path25.default.sep;
       if (!candidate.startsWith(baseResolved)) {
         throw new Error("Resolved temporary file escaped the base directory");
       }
@@ -84706,7 +84774,7 @@ var esm_default11 = createPrompt((config2, done) => {
 });
 
 // src/review-session.ts
-var import_neverthrow71 = __toESM(require_index_cjs(), 1);
+var import_neverthrow72 = __toESM(require_index_cjs(), 1);
 var FLOW_COL_WIDTH = 35;
 var TRIGGER_COL_WIDTH = 16;
 var CONFIDENCE_COL_WIDTH = 6;
@@ -84854,15 +84922,15 @@ async function runInteractiveLoop(findings, existing) {
   }
   return { staged: state.staged, undoneKeys: state.undoneKeys };
 }
-var safeRunInteractiveLoop = (0, import_neverthrow71.fromAsyncThrowable)(
+var safeRunInteractiveLoop = (0, import_neverthrow72.fromAsyncThrowable)(
   runInteractiveLoop,
   (error48) => error48 instanceof Error && error48.name === "ExitPromptError" ? "exit-prompt" : "unexpected"
 );
 
 // src/commands/review-command.ts
-var safeReadFile4 = (0, import_neverthrow72.fromThrowable)((filePath) => (0, import_node_fs10.readFileSync)(filePath, "utf8"));
-var safeParseJson4 = (0, import_neverthrow72.fromThrowable)(JSON.parse);
-var safeWrite = (0, import_neverthrow72.fromThrowable)((filePath, content) => {
+var safeReadFile4 = (0, import_neverthrow73.fromThrowable)((filePath) => (0, import_node_fs10.readFileSync)(filePath, "utf8"));
+var safeParseJson4 = (0, import_neverthrow73.fromThrowable)(JSON.parse);
+var safeWrite = (0, import_neverthrow73.fromThrowable)((filePath, content) => {
   (0, import_node_fs10.writeFileSync)(filePath, content);
 });
 function readLastPath(xqaDirectory) {
@@ -84879,13 +84947,13 @@ function isPipelineOutput(data) {
 function readFindings(filePath) {
   const readResult = safeReadFile4(filePath);
   if (readResult.isErr()) {
-    return (0, import_neverthrow72.err)("not-found");
+    return (0, import_neverthrow73.err)("not-found");
   }
   return safeParseJson4(readResult.value).mapErr(() => "invalid").andThen((data) => {
     if (!isPipelineOutput(data)) {
-      return (0, import_neverthrow72.err)("invalid");
+      return (0, import_neverthrow73.err)("invalid");
     }
-    return (0, import_neverthrow72.ok)(data);
+    return (0, import_neverthrow73.ok)(data);
   });
 }
 function loadExistingDismissals(filePath) {
@@ -84958,7 +85026,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_neverthrow72.err)();
+    return (0, import_neverthrow73.err)();
   }
   const resolvedPath = resolvedPathResult.value;
   const findingsResult = readFindings(resolvedPath);
@@ -84971,9 +85039,9 @@ function resolveAndReadFindings(findingsPath, xqaDirectory) {
 `);
     }
     process.exit(1);
-    return (0, import_neverthrow72.err)();
+    return (0, import_neverthrow73.err)();
   }
-  return (0, import_neverthrow72.ok)({ resolvedPath, output: findingsResult.value });
+  return (0, import_neverthrow73.ok)({ resolvedPath, output: findingsResult.value });
 }
 async function runReviewLoop({
   findings,
@@ -85001,7 +85069,7 @@ async function executeReview({
     process.exit(0);
     return;
   }
-  const dismissalsFilePath = dismissalsPath(import_node_path27.default.dirname(xqaDirectory), dismissalsPathOverride);
+  const dismissalsFilePath = dismissalsPath(import_node_path26.default.dirname(xqaDirectory), dismissalsPathOverride);
   await runReviewLoop({
     findings,
     dismissalsFilePath,
@@ -85043,14 +85111,14 @@ function discoverSimulators(udidOverride) {
 }
 
 // src/suite/commands/run/resolve-work-items.ts
-var import_promises28 = __toESM(require("node:fs/promises"), 1);
-var import_node_path28 = __toESM(require("node:path"), 1);
+var import_promises27 = __toESM(require("node:fs/promises"), 1);
+var import_node_path27 = __toESM(require("node:path"), 1);
 var import_fast_glob = __toESM(require_out4(), 1);
-var import_neverthrow75 = __toESM(require_index_cjs(), 1);
+var import_neverthrow76 = __toESM(require_index_cjs(), 1);
 
 // src/suite/core/suite-config-parser.ts
-var import_neverthrow73 = __toESM(require_index_cjs(), 1);
 var import_neverthrow74 = __toESM(require_index_cjs(), 1);
+var import_neverthrow75 = __toESM(require_index_cjs(), 1);
 var RESERVED_HOOK_ENV_KEYS = [
   "XQA_SIM_UDID",
   "XQA_ITEM_ID",
@@ -85102,7 +85170,7 @@ var suiteConfigSchema = external_exports.object({
 }).refine((data) => data.specs.length > 0 || data.freestyle.length > 0, {
   message: "Suite must declare at least one spec or freestyle entry"
 });
-var safeJsonParse5 = (0, import_neverthrow73.fromThrowable)(
+var safeJsonParse5 = (0, import_neverthrow74.fromThrowable)(
   JSON.parse,
   (cause) => ({
     type: "INVALID_SUITE_CONFIG",
@@ -85136,16 +85204,16 @@ function parseSuiteConfig(raw) {
   return safeJsonParse5(raw).andThen((data) => {
     const parsed = suiteConfigSchema.safeParse(data);
     if (!parsed.success) {
-      return (0, import_neverthrow74.err)({ type: "INVALID_SUITE_CONFIG", cause: parsed.error });
+      return (0, import_neverthrow75.err)({ type: "INVALID_SUITE_CONFIG", cause: parsed.error });
     }
     const hooks = normalizeHooks(parsed.data.hooks);
     if (hooks === void 0) {
-      return (0, import_neverthrow74.ok)({
+      return (0, import_neverthrow75.ok)({
         specs: parsed.data.specs,
         freestyle: parsed.data.freestyle
       });
     }
-    return (0, import_neverthrow74.ok)({
+    return (0, import_neverthrow75.ok)({
       specs: parsed.data.specs,
       freestyle: parsed.data.freestyle,
       hooks
@@ -85193,15 +85261,15 @@ function buildFreestyleItems(entries) {
 }
 
 // src/suite/commands/run/resolve-work-items.ts
-var safeReadFile5 = import_neverthrow75.ResultAsync.fromThrowable(
-  async (filePath) => import_promises28.default.readFile(filePath, "utf8"),
+var safeReadFile5 = import_neverthrow76.ResultAsync.fromThrowable(
+  async (filePath) => import_promises27.default.readFile(filePath, "utf8"),
   () => "READ_FAILED"
 );
 async function resolveGlobs(input) {
   return (0, import_fast_glob.default)(input.globs, { cwd: input.cwd, absolute: true });
 }
 async function loadSuiteConfig(suitesDirectory, name) {
-  const suitePath = import_node_path28.default.join(suitesDirectory, `${name}.suite.json`);
+  const suitePath = import_node_path27.default.join(suitesDirectory, `${name}.suite.json`);
   const contentResult = await safeReadFile5(suitePath);
   if (contentResult.isErr()) {
     return;
@@ -85261,7 +85329,7 @@ async function resolveAndFilterItems(input) {
 }
 
 // src/suite/shell/worker-pool.ts
-var import_neverthrow78 = __toESM(require_index_cjs(), 1);
+var import_neverthrow79 = __toESM(require_index_cjs(), 1);
 
 // src/suite/core/priority-queue.ts
 var PriorityQueue = class {
@@ -85508,7 +85576,7 @@ function recordHookFailure(input) {
 }
 
 // src/suite/shell/hook-invoker.ts
-var import_neverthrow77 = __toESM(require_index_cjs(), 1);
+var import_neverthrow78 = __toESM(require_index_cjs(), 1);
 
 // src/suite/core/hook-env-builder.ts
 function buildReservedKeys(input) {
@@ -85534,8 +85602,8 @@ function buildHookEnv(input) {
 }
 
 // src/suite/shell/hook-runner.ts
-var import_node_child_process7 = require("node:child_process");
-var import_neverthrow76 = __toESM(require_index_cjs(), 1);
+var import_node_child_process8 = require("node:child_process");
+var import_neverthrow77 = __toESM(require_index_cjs(), 1);
 function makeDeferred() {
   const raw = Promise.withResolvers();
   return { promise: raw.promise, resolve: raw.resolve };
@@ -85555,7 +85623,7 @@ var HookRuntime = class {
   onAbort;
   constructor(options2) {
     const { script, cwd, env: env3, baseEnv, nodeExecPath, timeoutMs, signal } = options2;
-    this.child = (0, import_node_child_process7.spawn)(nodeExecPath, [script], {
+    this.child = (0, import_node_child_process8.spawn)(nodeExecPath, [script], {
       cwd,
       env: { ...baseEnv, ...env3 },
       stdio: ["ignore", "inherit", "pipe"]
@@ -85565,7 +85633,7 @@ var HookRuntime = class {
     this.deferred = makeDeferred();
     this.onAbort = () => {
       this.child.kill("SIGTERM");
-      this.settle((0, import_neverthrow76.err)({ type: "HOOK_ABORTED" }));
+      this.settle((0, import_neverthrow77.err)({ type: "HOOK_ABORTED" }));
     };
   }
   async start() {
@@ -85590,20 +85658,20 @@ var HookRuntime = class {
   attachTimeout() {
     this.timeoutHandle = setTimeout(() => {
       this.child.kill("SIGTERM");
-      this.settle((0, import_neverthrow76.err)({ type: "HOOK_TIMEOUT", timeoutMs: this.timeoutMs }));
+      this.settle((0, import_neverthrow77.err)({ type: "HOOK_TIMEOUT", timeoutMs: this.timeoutMs }));
     }, this.timeoutMs);
   }
   attachChildListeners() {
     this.child.on("error", (cause) => {
-      this.settle((0, import_neverthrow76.err)({ type: "HOOK_SPAWN_FAILED", cause }));
+      this.settle((0, import_neverthrow77.err)({ type: "HOOK_SPAWN_FAILED", cause }));
     });
     this.child.on("exit", (code) => {
       if (code === 0) {
-        this.settle((0, import_neverthrow76.ok)());
+        this.settle((0, import_neverthrow77.ok)());
         return;
       }
       this.settle(
-        (0, import_neverthrow76.err)({
+        (0, import_neverthrow77.err)({
           type: "HOOK_EXIT_NONZERO",
           code: code ?? -1,
           stderr: this.stderrBuffer
@@ -85626,7 +85694,7 @@ var HookRuntime = class {
     this.signal.removeEventListener("abort", this.onAbort);
   }
 };
-var safeSpawn = import_neverthrow76.ResultAsync.fromThrowable(
+var safeSpawn = import_neverthrow77.ResultAsync.fromThrowable(
   spawnHook,
   (cause) => ({ type: "HOOK_SPAWN_FAILED", cause })
 );
@@ -85654,7 +85722,7 @@ async function invokeHook(input) {
 async function maybeInvokeHook(input) {
   const { hook: hook2 } = input;
   if (hook2 === void 0) {
-    return (0, import_neverthrow77.ok)();
+    return (0, import_neverthrow78.ok)();
   }
   return invokeHook({ ...input, hook: hook2 });
 }
@@ -85748,7 +85816,7 @@ async function processItem(workerContext, item) {
   workerContext.inFlight.delete(item.id);
   return failCount;
 }
-var safeProcessItem = import_neverthrow78.ResultAsync.fromThrowable(
+var safeProcessItem = import_neverthrow79.ResultAsync.fromThrowable(
   processItem,
   (cause) => ({
     type: "PROCESS_ITEM_FAILED",
@@ -85813,7 +85881,7 @@ function runWorkerPool(config2) {
   const results = [];
   const inFlight = /* @__PURE__ */ new Map();
   const suiteStartMs = Date.now();
-  const safeRun = import_neverthrow78.ResultAsync.fromThrowable(
+  const safeRun = import_neverthrow79.ResultAsync.fromThrowable(
     async () => runAllWorkers({ config: config2, queue, results, suiteStartMs, inFlight }),
     (cause) => ({ type: "WORKER_POOL_FAILED", cause })
   );
@@ -85823,7 +85891,7 @@ function runWorkerPool(config2) {
 // src/suite/commands/pipeline-config-builder.ts
 var import_node_fs11 = require("node:fs");
 var import_node_os4 = __toESM(require("node:os"), 1);
-var import_node_path29 = __toESM(require("node:path"), 1);
+var import_node_path28 = __toESM(require("node:path"), 1);
 var DEFAULT_FREESTYLE_TIMEOUT_SECONDS2 = 300;
 function buildDeviceInstruction(simulatorUdid) {
   return `You MUST use device "${simulatorUdid}" for ALL mobile tool calls. The simulator UDID is already configured \u2014 use it directly.`;
@@ -85832,7 +85900,7 @@ function composeAppContext(parts) {
   return parts.filter((part) => part !== void 0 && part.length > 0).join("\n\n");
 }
 function ensureWorkerCwd(simulatorUdid) {
-  const workerDirectory = import_node_path29.default.join(import_node_os4.default.tmpdir(), "xqa-workers", simulatorUdid);
+  const workerDirectory = import_node_path28.default.join(import_node_os4.default.tmpdir(), "xqa-workers", simulatorUdid);
   (0, import_node_fs11.mkdirSync)(workerDirectory, { recursive: true });
   return workerDirectory;
 }
@@ -85898,7 +85966,7 @@ function buildPipelineConfig2(input) {
   const { item, context, signal, simulatorUdid, onEvent } = input;
   const { xqaDirectory, runId, config: config2, rootConfig } = context;
   const base = {
-    outputDir: import_node_path29.default.join(xqaDirectory, "output", item.id),
+    outputDir: import_node_path28.default.join(xqaDirectory, "output", item.id),
     runId,
     simulatorUdid,
     signal,
@@ -85967,25 +86035,25 @@ function buildSuiteFindings(input) {
 }
 
 // src/suite/shell/suite-findings-writer.ts
-var import_promises29 = __toESM(require("node:fs/promises"), 1);
-var import_node_path30 = __toESM(require("node:path"), 1);
-var import_neverthrow79 = __toESM(require_index_cjs(), 1);
+var import_promises28 = __toESM(require("node:fs/promises"), 1);
+var import_node_path29 = __toESM(require("node:path"), 1);
+var import_neverthrow80 = __toESM(require_index_cjs(), 1);
 var INDENT_SPACES = 2;
 function writeSuiteFindings(findings, options2) {
-  const directory = import_node_path30.default.join(
+  const directory = import_node_path29.default.join(
     options2.outputDirectory,
     "suite",
     findings.suiteId,
     options2.date,
     findings.runId
   );
-  const finalPath = import_node_path30.default.join(directory, "findings.json");
+  const finalPath = import_node_path29.default.join(directory, "findings.json");
   const temporaryPath = `${finalPath}.tmp`;
-  const safeWriteAtomically = import_neverthrow79.ResultAsync.fromThrowable(
+  const safeWriteAtomically = import_neverthrow80.ResultAsync.fromThrowable(
     async () => {
-      await import_promises29.default.mkdir(directory, { recursive: true });
-      await import_promises29.default.writeFile(temporaryPath, JSON.stringify(findings, void 0, INDENT_SPACES));
-      await import_promises29.default.rename(temporaryPath, finalPath);
+      await import_promises28.default.mkdir(directory, { recursive: true });
+      await import_promises28.default.writeFile(temporaryPath, JSON.stringify(findings, void 0, INDENT_SPACES));
+      await import_promises28.default.rename(temporaryPath, finalPath);
       return finalPath;
     },
     (cause) => ({ type: "FINDINGS_WRITE_FAILED", cause })
@@ -86013,9 +86081,9 @@ async function writeAndReport(input) {
 }
 
 // src/suite/commands/suite-run-context.ts
-var import_promises30 = __toESM(require("node:fs/promises"), 1);
-var import_node_path31 = __toESM(require("node:path"), 1);
-var import_neverthrow80 = __toESM(require_index_cjs(), 1);
+var import_promises29 = __toESM(require("node:fs/promises"), 1);
+var import_node_path30 = __toESM(require("node:path"), 1);
+var import_neverthrow81 = __toESM(require_index_cjs(), 1);
 
 // src/suite/core/run-id.ts
 var RUN_ID_PAD_LENGTH2 = 4;
@@ -86050,16 +86118,16 @@ function deriveSuiteId(input) {
 
 // src/suite/commands/suite-run-context.ts
 var ISO_DATE_LENGTH3 = 10;
-var safeReaddir3 = import_neverthrow80.ResultAsync.fromThrowable(
+var safeReaddir3 = import_neverthrow81.ResultAsync.fromThrowable(
   async (directoryPath) => {
-    const entries = await import_promises30.default.readdir(directoryPath, { withFileTypes: true });
+    const entries = await import_promises29.default.readdir(directoryPath, { withFileTypes: true });
     return entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name);
   },
   () => "READDIR_FAILED"
 );
 async function listRunDirectories(input) {
   const { outputDirectory, suiteId, date: date5 } = input;
-  const directoryPath = import_node_path31.default.join(outputDirectory, "suite", suiteId, date5);
+  const directoryPath = import_node_path30.default.join(outputDirectory, "suite", suiteId, date5);
   const result = await safeReaddir3(directoryPath);
   return result.unwrapOr([]);
 }
@@ -86083,7 +86151,7 @@ ${cause}
 async function buildSuiteRunContext(input) {
   const suiteId = deriveSuiteIdFromMode(input.mode);
   const date5 = (/* @__PURE__ */ new Date()).toISOString().slice(0, ISO_DATE_LENGTH3);
-  const outputDirectory = import_node_path31.default.join(input.xqaDirectory, "output");
+  const outputDirectory = import_node_path30.default.join(input.xqaDirectory, "output");
   const existingDirectories = await listRunDirectories({ outputDirectory, suiteId, date: date5 });
   const runId = computeNextRunId2(existingDirectories);
   const appContext = await loadAppContext(input.xqaDirectory);
@@ -86185,18 +86253,18 @@ async function runSuiteCommand(input) {
 }
 
 // src/suite/commands/validate-run-arguments.ts
-var import_neverthrow81 = __toESM(require_index_cjs(), 1);
+var import_neverthrow82 = __toESM(require_index_cjs(), 1);
 function validateRunArguments(options2) {
   if (options2.suite === void 0 && options2.spec === void 0) {
-    return (0, import_neverthrow81.err)({ type: "MISSING_SUITE_OR_SPEC" });
+    return (0, import_neverthrow82.err)({ type: "MISSING_SUITE_OR_SPEC" });
   }
   if (options2.suite !== void 0 && options2.spec !== void 0) {
-    return (0, import_neverthrow81.err)({ type: "BOTH_SUITE_AND_SPEC" });
+    return (0, import_neverthrow82.err)({ type: "BOTH_SUITE_AND_SPEC" });
   }
   if (options2.only !== void 0 && options2.suite === void 0) {
-    return (0, import_neverthrow81.err)({ type: "ONLY_REQUIRES_SUITE" });
+    return (0, import_neverthrow82.err)({ type: "ONLY_REQUIRES_SUITE" });
   }
-  return (0, import_neverthrow81.ok)(
+  return (0, import_neverthrow82.ok)(
     options2.suite === void 0 ? { type: "spec", globs: options2.spec ?? [] } : { type: "suite", name: options2.suite }
   );
 }
@@ -86244,10 +86312,10 @@ function registerRunCommand(program3, loader2) {
 }
 
 // src/commands/spec/runner.ts
-var import_node_path35 = __toESM(require("node:path"), 1);
+var import_node_path34 = __toESM(require("node:path"), 1);
 
 // src/commands/spec/pipeline-config.ts
-var import_node_path32 = __toESM(require("node:path"), 1);
+var import_node_path31 = __toESM(require("node:path"), 1);
 function buildInspector3(context) {
   const { inspector } = context.rootConfig.agents;
   if (!inspector.enabled) {
@@ -86272,7 +86340,7 @@ function buildSpecExplorer2(context) {
 }
 function buildPipelineConfig3({ input, context, onEvent }) {
   return {
-    outputDir: import_node_path32.default.join(context.xqaDirectory, "output", context.slug),
+    outputDir: import_node_path31.default.join(context.xqaDirectory, "output", context.slug),
     signal: input.signal,
     onEvent,
     inspector: buildInspector3(context),
@@ -86331,13 +86399,13 @@ function handleSpecResult(state, context) {
 }
 
 // src/spec-slug.ts
-var import_node_path33 = __toESM(require("node:path"), 1);
+var import_node_path32 = __toESM(require("node:path"), 1);
 var SPECS_DIR = "specs";
 function stripExtensions(filename) {
   return filename.replace(/\.test\.md$/, "").replace(/\.[^.]+$/, "");
 }
 function deriveSpecSlug(specFilePath) {
-  const parts = specFilePath.split(import_node_path33.default.sep);
+  const parts = specFilePath.split(import_node_path32.default.sep);
   const specsIndex = parts.lastIndexOf(SPECS_DIR);
   if (specsIndex !== -1) {
     const relativeParts = parts.slice(specsIndex + 1);
@@ -86345,60 +86413,60 @@ function deriveSpecSlug(specFilePath) {
     relativeParts[relativeParts.length - 1] = stripExtensions(last);
     return relativeParts.join("__");
   }
-  return stripExtensions(import_node_path33.default.basename(specFilePath));
+  return stripExtensions(import_node_path32.default.basename(specFilePath));
 }
 
 // src/commands/spec-resolver.ts
 var import_node_fs12 = require("node:fs");
-var import_node_path34 = __toESM(require("node:path"), 1);
-var import_neverthrow83 = __toESM(require_index_cjs(), 1);
+var import_node_path33 = __toESM(require("node:path"), 1);
+var import_neverthrow84 = __toESM(require_index_cjs(), 1);
 
 // src/spec-frontmatter.ts
 var import_gray_matter = __toESM(require_gray_matter(), 1);
-var import_neverthrow82 = __toESM(require_index_cjs(), 1);
+var import_neverthrow83 = __toESM(require_index_cjs(), 1);
 var frontmatterSchema = external_exports.object({
   feature: external_exports.string().min(1),
   timeout: external_exports.number().int().positive().optional()
 });
-var safeParseMatter = (0, import_neverthrow82.fromThrowable)(
+var safeParseMatter = (0, import_neverthrow83.fromThrowable)(
   import_gray_matter.default,
   (cause) => ({ type: "SPEC_FRONTMATTER_INVALID", cause })
 );
 function validate(data) {
   const parsed = frontmatterSchema.safeParse(data);
   if (!parsed.success) {
-    return (0, import_neverthrow82.err)({ type: "SPEC_FRONTMATTER_INVALID", cause: parsed.error });
+    return (0, import_neverthrow83.err)({ type: "SPEC_FRONTMATTER_INVALID", cause: parsed.error });
   }
   const { feature, timeout } = parsed.data;
   if (timeout === void 0) {
-    return (0, import_neverthrow82.ok)({ feature });
+    return (0, import_neverthrow83.ok)({ feature });
   }
-  return (0, import_neverthrow82.ok)({ feature, timeoutSeconds: timeout });
+  return (0, import_neverthrow83.ok)({ feature, timeoutSeconds: timeout });
 }
 function parseSpecFrontmatter(raw) {
   return safeParseMatter(raw).andThen((parsed) => validate(parsed.data));
 }
 
 // src/commands/spec-resolver.ts
-var safeReadFile6 = (0, import_neverthrow83.fromThrowable)((filePath) => (0, import_node_fs12.readFileSync)(filePath, "utf8"));
-var safeReaddir4 = (0, import_neverthrow83.fromThrowable)(
+var safeReadFile6 = (0, import_neverthrow84.fromThrowable)((filePath) => (0, import_node_fs12.readFileSync)(filePath, "utf8"));
+var safeReaddir4 = (0, import_neverthrow84.fromThrowable)(
   (directory) => (0, import_node_fs12.readdirSync)(directory, { recursive: true, encoding: "utf8" })
 );
 var CANCEL = "xqa:cancel";
-var safeSelect = import_neverthrow83.ResultAsync.fromThrowable(
+var safeSelect = import_neverthrow84.ResultAsync.fromThrowable(
   esm_default11,
   (error48) => error48 instanceof Error && error48.name === "ExitPromptError" ? "cancelled" : "failed"
 );
 function findSpecFiles(xqaDirectory) {
-  const specsDirectory = import_node_path34.default.join(xqaDirectory, "specs");
-  return safeReaddir4(specsDirectory).unwrapOr([]).filter((file2) => file2.endsWith(".test.md")).map((file2) => import_node_path34.default.join(specsDirectory, file2));
+  const specsDirectory = import_node_path33.default.join(xqaDirectory, "specs");
+  return safeReaddir4(specsDirectory).unwrapOr([]).filter((file2) => file2.endsWith(".test.md")).map((file2) => import_node_path33.default.join(specsDirectory, file2));
 }
 async function promptForSpec(specFiles, xqaDirectory) {
   const result = await safeSelect({
     message: "Select a spec",
     choices: [
       ...specFiles.map((specFile) => ({
-        name: import_node_path34.default.relative(xqaDirectory, specFile),
+        name: import_node_path33.default.relative(xqaDirectory, specFile),
         value: specFile
       })),
       new Separator(),
@@ -86448,7 +86516,7 @@ async function executeSpec(input, context) {
   const identity = {
     display: createSoloDisplay(input.verbose),
     itemId: "spec",
-    itemName: import_node_path35.default.basename(context.absolutePath, ".test.md"),
+    itemName: import_node_path34.default.basename(context.absolutePath, ".test.md"),
     simulatorUdid: ""
   };
   const startedAt = Date.now();
@@ -86483,7 +86551,7 @@ async function resolveSpecContext(input, options2) {
   if (resolvedSpecFile === void 0) {
     return;
   }
-  const absolutePath = import_node_path35.default.resolve(resolvedSpecFile);
+  const absolutePath = import_node_path34.default.resolve(resolvedSpecFile);
   const frontmatter = readAndParseSpec(absolutePath);
   if (frontmatter === void 0) {
     return;
@@ -86528,7 +86596,7 @@ function registerSpecCommand(program3, loader2) {
 }
 
 // ../../agents/triager/dist/index.js
-var import_neverthrow84 = __toESM(require_index_cjs(), 1);
+var import_neverthrow85 = __toESM(require_index_cjs(), 1);
 
 // ../../node_modules/.pnpm/balanced-match@4.0.4/node_modules/balanced-match/dist/esm/index.js
 var balanced = (a3, b, str3) => {
@@ -88333,14 +88401,14 @@ minimatch.escape = escape2;
 minimatch.unescape = unescape2;
 
 // ../../agents/triager/dist/index.js
-var import_neverthrow85 = __toESM(require_index_cjs(), 1);
-var import_promises31 = require("node:fs/promises");
 var import_neverthrow86 = __toESM(require_index_cjs(), 1);
-var import_node_child_process8 = require("node:child_process");
-var import_promises32 = require("node:fs/promises");
-var import_node_path36 = __toESM(require("node:path"), 1);
+var import_promises30 = require("node:fs/promises");
 var import_neverthrow87 = __toESM(require_index_cjs(), 1);
+var import_node_child_process9 = require("node:child_process");
+var import_promises31 = require("node:fs/promises");
+var import_node_path35 = __toESM(require("node:path"), 1);
 var import_neverthrow88 = __toESM(require_index_cjs(), 1);
+var import_neverthrow89 = __toESM(require_index_cjs(), 1);
 function resolveConfidence2(selected) {
   if (selected.some((pick2) => pick2.confidence === "HIGH")) {
     return "high";
@@ -88959,7 +89027,7 @@ function buildMcpServer(state, options2) {
   });
   return xx({ name: TRIAGER_MCP_SERVER_NAME, version: "0.0.0", tools });
 }
-function buildAllowedTools() {
+function buildAllowedTools2() {
   return [
     `${TOOL_PREFIX}read_spec`,
     `${TOOL_PREFIX}read_app_section`,
@@ -88970,7 +89038,7 @@ function buildAllowedTools() {
 function buildQueryOptions2(input) {
   return {
     mcpServers: { [TRIAGER_MCP_SERVER_NAME]: input.server },
-    allowedTools: buildAllowedTools(),
+    allowedTools: buildAllowedTools2(),
     tools: [],
     permissionMode: "bypassPermissions",
     allowDangerouslySkipPermissions: true,
@@ -89005,7 +89073,7 @@ async function drainMessages(runner, state) {
     }
   }
 }
-var safeDrainMessages = import_neverthrow85.ResultAsync.fromThrowable(
+var safeDrainMessages = import_neverthrow86.ResultAsync.fromThrowable(
   drainMessages,
   (cause) => ({ type: "AI_CALL_FAILED", cause })
 );
@@ -89031,25 +89099,25 @@ function finalizeRun(bootstrap) {
   const telemetry = buildTelemetry(bootstrap.telemetryInput, bootstrap.state);
   const error48 = resolveError(bootstrap.state);
   if (error48 !== void 0) {
-    return (0, import_neverthrow85.errAsync)(error48);
+    return (0, import_neverthrow86.errAsync)(error48);
   }
   const output = bootstrap.state.output;
   if (output === void 0) {
-    return (0, import_neverthrow85.errAsync)({ type: "AI_NO_FINAL_TOOL_CALL" });
+    return (0, import_neverthrow86.errAsync)({ type: "AI_NO_FINAL_TOOL_CALL" });
   }
   bootstrap.reportTelemetry(telemetry);
-  return (0, import_neverthrow85.okAsync)({ picks: output.picks, metaPr: output.metaPr, telemetry });
+  return (0, import_neverthrow86.okAsync)({ picks: output.picks, metaPr: output.metaPr, telemetry });
 }
 function launchQuery(input) {
-  const safeLaunch = (0, import_neverthrow85.fromThrowable)(
+  const safeLaunch = (0, import_neverthrow86.fromThrowable)(
     input.queryRunner,
     (cause) => ({ type: "AI_CALL_FAILED", cause })
   );
   const result = safeLaunch({ prompt: input.inputQueue, options: input.queryOptions });
   if (result.isErr()) {
-    return (0, import_neverthrow85.errAsync)(result.error);
+    return (0, import_neverthrow86.errAsync)(result.error);
   }
-  return (0, import_neverthrow85.okAsync)(result.value);
+  return (0, import_neverthrow86.okAsync)(result.value);
 }
 function runPipeline4(bootstrap) {
   return launchQuery({
@@ -89103,9 +89171,9 @@ var STATIC_ONLY_FIELDS = {
   freestyleByGroup: /* @__PURE__ */ new Map(),
   appIndex: [],
   handlers: {
-    readSpec: () => (0, import_neverthrow84.errAsync)({ type: "FILE_NOT_FOUND", path: "" }),
-    readAppSection: () => (0, import_neverthrow84.errAsync)({ type: "FILE_NOT_FOUND", path: "" }),
-    grepCodebase: () => (0, import_neverthrow84.errAsync)({ type: "FILE_NOT_FOUND", path: "" })
+    readSpec: () => (0, import_neverthrow85.errAsync)({ type: "FILE_NOT_FOUND", path: "" }),
+    readAppSection: () => (0, import_neverthrow85.errAsync)({ type: "FILE_NOT_FOUND", path: "" }),
+    grepCodebase: () => (0, import_neverthrow85.errAsync)({ type: "FILE_NOT_FOUND", path: "" })
   }
 };
 function resolveAiFields(config2) {
@@ -89226,15 +89294,15 @@ function runAiTiebreaker(context, staticPicks) {
 function runTriager(options2) {
   const { groups, config: config2 } = options2;
   if (groups.length === 0) {
-    return (0, import_neverthrow84.errAsync)({ type: "NO_GROUPS" });
+    return (0, import_neverthrow85.errAsync)({ type: "NO_GROUPS" });
   }
   if (config2?.useAi === true && config2.ai === void 0) {
-    return (0, import_neverthrow84.errAsync)({ type: "AI_CONFIG_MISSING" });
+    return (0, import_neverthrow85.errAsync)({ type: "AI_CONFIG_MISSING" });
   }
   const context = buildContext2(options2);
   const staticPicks = scoreGroups(context.diff, context.groups);
   if (!context.useAi) {
-    return (0, import_neverthrow84.okAsync)(buildDecision({ picks: staticPicks, metaPr: false }));
+    return (0, import_neverthrow85.okAsync)(buildDecision({ picks: staticPicks, metaPr: false }));
   }
   return runAiTiebreaker(context, staticPicks);
 }
@@ -89295,17 +89363,17 @@ function parseSections(text) {
 function lookupSection(sections, screenName) {
   const section = sections.get(screenName);
   if (section === void 0) {
-    return (0, import_neverthrow86.errAsync)({ type: "SECTION_NOT_FOUND", screenName });
+    return (0, import_neverthrow87.errAsync)({ type: "SECTION_NOT_FOUND", screenName });
   }
-  return (0, import_neverthrow86.okAsync)(section);
+  return (0, import_neverthrow87.okAsync)(section);
 }
 async function readUtf8File(filePath) {
-  return (0, import_promises31.readFile)(filePath, UTF8);
+  return (0, import_promises30.readFile)(filePath, UTF8);
 }
 function createAppMdReader(options2) {
   const filePath = options2.path;
   let sectionCache;
-  const safeReadFile7 = import_neverthrow86.ResultAsync.fromThrowable(
+  const safeReadFile7 = import_neverthrow87.ResultAsync.fromThrowable(
     readUtf8File,
     (cause) => classifyReadError(cause, filePath)
   );
@@ -89342,7 +89410,7 @@ function buildSpawnExitError(code, stderr) {
 }
 async function runExecFile(request2) {
   const { promise: promise2, resolve, reject } = Promise.withResolvers();
-  const child = (0, import_node_child_process8.spawn)(request2.binary, [...request2.arguments_], { cwd: request2.cwd });
+  const child = (0, import_node_child_process9.spawn)(request2.binary, [...request2.arguments_], { cwd: request2.cwd });
   const stdoutChunks = [];
   const stderrChunks = [];
   child.stdout.on("data", (chunk) => {
@@ -89366,10 +89434,10 @@ async function runExecFile(request2) {
   return promise2;
 }
 function resolveFilePath(filePath, cwd) {
-  if (import_node_path36.default.isAbsolute(filePath)) {
+  if (import_node_path35.default.isAbsolute(filePath)) {
     return filePath;
   }
-  return import_node_path36.default.resolve(cwd, filePath);
+  return import_node_path35.default.resolve(cwd, filePath);
 }
 function classifyReadError2(cause, resolvedPath) {
   const nodeError = cause;
@@ -89423,24 +89491,24 @@ async function invokeRipgrep(options2) {
   return runExecFile({ binary: binary2, arguments_, cwd });
 }
 function execRipgrepRaw(options2) {
-  const safeExec = import_neverthrow87.ResultAsync.fromThrowable(invokeRipgrep, classifyRawExecError);
+  const safeExec = import_neverthrow88.ResultAsync.fromThrowable(invokeRipgrep, classifyRawExecError);
   return safeExec(options2);
 }
 function handleExecResult(options2) {
   return execRipgrepRaw(options2).orElse((error48) => {
     if (error48.type === "GREP_FAILED" && error48.cause.code === RIPGREP_NO_MATCH_CODE) {
-      return (0, import_neverthrow87.ok)({ stdout: "", stderr: "" });
+      return (0, import_neverthrow88.ok)({ stdout: "", stderr: "" });
     }
-    return (0, import_neverthrow87.err)(error48);
+    return (0, import_neverthrow88.err)(error48);
   });
 }
 async function readUtf8File2(filePath) {
-  return (0, import_promises32.readFile)(filePath, "utf8");
+  return (0, import_promises31.readFile)(filePath, "utf8");
 }
 function makeReadFile(cwd) {
   return (filePath) => {
     const resolvedPath = resolveFilePath(filePath, cwd);
-    const safeRead = import_neverthrow87.ResultAsync.fromThrowable(
+    const safeRead = import_neverthrow88.ResultAsync.fromThrowable(
       readUtf8File2,
       (cause) => classifyReadError2(cause, resolvedPath)
     );
@@ -89507,9 +89575,9 @@ function applyHeading(state, screenName) {
 function handleHeading(state, indexed) {
   const screenName = indexed.text.slice(LEVEL_2_HEADING_MARKER.length).trim();
   if (screenName.length === 0) {
-    return (0, import_neverthrow88.err)({ type: "APP_MD_MALFORMED", line: indexed.number });
+    return (0, import_neverthrow89.err)({ type: "APP_MD_MALFORMED", line: indexed.number });
   }
-  return (0, import_neverthrow88.ok)(applyHeading(state, screenName));
+  return (0, import_neverthrow89.ok)(applyHeading(state, screenName));
 }
 function handleFenceLine(state, lineNumber) {
   if (state.insideFence) {
@@ -89543,23 +89611,23 @@ function isLevel2Heading(line) {
 }
 function processLine2(state, indexed) {
   if (indexed.text.startsWith(FENCE_MARKER)) {
-    return (0, import_neverthrow88.ok)(handleFenceLine(state, indexed.number));
+    return (0, import_neverthrow89.ok)(handleFenceLine(state, indexed.number));
   }
   if (state.insideFence) {
-    return (0, import_neverthrow88.ok)(state);
+    return (0, import_neverthrow89.ok)(state);
   }
   if (isLevel2Heading(indexed.text)) {
     return handleHeading(state, indexed);
   }
   if (indexed.text.trim().length === 0) {
-    return (0, import_neverthrow88.ok)(handleBlankLine(state));
+    return (0, import_neverthrow89.ok)(handleBlankLine(state));
   }
-  return (0, import_neverthrow88.ok)(handleContentLine(state, indexed.text));
+  return (0, import_neverthrow89.ok)(handleContentLine(state, indexed.text));
 }
 function processIndexedLines(indexedLines, state) {
   const [head, ...tail] = indexedLines;
   if (head === void 0) {
-    return (0, import_neverthrow88.ok)(state);
+    return (0, import_neverthrow89.ok)(state);
   }
   return processLine2(state, head).andThen((next) => processIndexedLines(tail, next));
 }
@@ -89571,9 +89639,9 @@ function buildFinalEntries(state) {
 }
 function finaliseState(state) {
   if (state.insideFence) {
-    return (0, import_neverthrow88.err)({ type: "APP_MD_MALFORMED", line: state.fenceOpenLine });
+    return (0, import_neverthrow89.err)({ type: "APP_MD_MALFORMED", line: state.fenceOpenLine });
   }
-  return (0, import_neverthrow88.ok)([...buildFinalEntries(state)]);
+  return (0, import_neverthrow89.ok)([...buildFinalEntries(state)]);
 }
 function buildAppIndex(appMd) {
   const indexedLines = toIndexedLines(appMd.split("\n"));
@@ -89604,11 +89672,11 @@ function summariseSpec(input) {
 var triagerConfigSchema = agentBaseConfigSchema.extend({ enabled: external_exports.boolean().default(false) }).strict();
 
 // src/commands/triage-command.ts
-var import_neverthrow93 = __toESM(require_index_cjs(), 1);
+var import_neverthrow94 = __toESM(require_index_cjs(), 1);
 
 // src/triage/ai-context-builder.ts
-var import_node_path37 = __toESM(require("node:path"), 1);
-var import_neverthrow89 = __toESM(require_index_cjs(), 1);
+var import_node_path36 = __toESM(require("node:path"), 1);
+var import_neverthrow90 = __toESM(require_index_cjs(), 1);
 var PROMPT_VERSION = "v1";
 var MAX_GREP_PATTERN_LENGTH = 200;
 var DENIED_SAMPLE_PATHS = [
@@ -89687,11 +89755,11 @@ function isDeniedGlob(pathGlob) {
   return normalized !== pathGlob && matchesDeniedSample(normalized);
 }
 function pathDenied(reason) {
-  return (0, import_neverthrow89.errAsync)({ type: "PATH_DENIED", reason });
+  return (0, import_neverthrow90.errAsync)({ type: "PATH_DENIED", reason });
 }
 function buildHandlers(cwd, validSpecIds) {
   const reader = createCodebaseReader({ cwd });
-  const appMdPath = import_node_path37.default.join(cwd, "app.md");
+  const appMdPath = import_node_path36.default.join(cwd, "app.md");
   const appMdReader = createAppMdReader({ path: appMdPath });
   return {
     readSpec: (id) => {
@@ -89713,20 +89781,20 @@ function buildHandlers(cwd, validSpecIds) {
   };
 }
 function resolveAppMdPath(suitesDirectory) {
-  return import_node_path37.default.join(import_node_path37.default.dirname(import_node_path37.default.resolve(suitesDirectory)), "app.md");
+  return import_node_path36.default.join(import_node_path36.default.dirname(import_node_path36.default.resolve(suitesDirectory)), "app.md");
 }
 function loadAppIndex(appMdPath) {
-  const appMdReader = createCodebaseReader({ cwd: import_node_path37.default.dirname(appMdPath) });
+  const appMdReader = createCodebaseReader({ cwd: import_node_path36.default.dirname(appMdPath) });
   return appMdReader.readFile(appMdPath).mapErr(() => ({ type: "SPEC_NOT_FOUND", path: appMdPath })).andThen((content) => {
     const indexResult = buildAppIndex(content);
     if (indexResult.isErr()) {
-      return (0, import_neverthrow89.errAsync)({
+      return (0, import_neverthrow90.errAsync)({
         type: "SUITE_INVALID",
         path: appMdPath,
         cause: indexResult.error
       });
     }
-    return (0, import_neverthrow89.okAsync)(indexResult.value);
+    return (0, import_neverthrow90.okAsync)(indexResult.value);
   });
 }
 function collectSpecIds(specSummariesByGroup) {
@@ -93301,7 +93369,7 @@ var Octokit2 = Octokit.plugin(requestLog, legacyRestEndpointMethods, paginateRes
 );
 
 // src/triage/github-pr-fetcher.ts
-var import_neverthrow90 = __toESM(require_index_cjs(), 1);
+var import_neverthrow91 = __toESM(require_index_cjs(), 1);
 var STATUS_MAP = {
   added: "added",
   modified: "modified",
@@ -93337,11 +93405,11 @@ async function runListFiles(octokit, options2) {
     per_page: 100
   });
 }
-var safeGet = import_neverthrow90.ResultAsync.fromThrowable(
+var safeGet = import_neverthrow91.ResultAsync.fromThrowable(
   runPullRequestGet,
   (cause) => ({ type: "PR_FETCH_FAILED", cause })
 );
-var safeList = import_neverthrow90.ResultAsync.fromThrowable(
+var safeList = import_neverthrow91.ResultAsync.fromThrowable(
   runListFiles,
   (cause) => ({ type: "PR_FETCH_FAILED", cause })
 );
@@ -93355,13 +93423,13 @@ function toDiff(summary, files) {
 }
 function fetchPullRequestDiff(options2) {
   const octokit = new Octokit2({ auth: options2.token });
-  return import_neverthrow90.ResultAsync.combine([safeGet(octokit, options2), safeList(octokit, options2)]).map(
+  return import_neverthrow91.ResultAsync.combine([safeGet(octokit, options2), safeList(octokit, options2)]).map(
     ([summary, files]) => toDiff(summary, files)
   );
 }
 
 // src/triage/github-pr-labeller.ts
-var import_neverthrow91 = __toESM(require_index_cjs(), 1);
+var import_neverthrow92 = __toESM(require_index_cjs(), 1);
 async function runAddLabels(octokit, options2) {
   await octokit.issues.addLabels({
     owner: options2.owner,
@@ -93370,7 +93438,7 @@ async function runAddLabels(octokit, options2) {
     labels: [...options2.labels]
   });
 }
-var safeAddLabels = import_neverthrow91.ResultAsync.fromThrowable(
+var safeAddLabels = import_neverthrow92.ResultAsync.fromThrowable(
   runAddLabels,
   (cause) => ({ type: "LABEL_APPLY_FAILED", cause })
 );
@@ -93408,9 +93476,9 @@ function formatXqaLabels(decision) {
 }
 
 // src/triage/suite-loader.ts
-var import_promises33 = require("node:fs/promises");
-var import_node_path38 = __toESM(require("node:path"), 1);
-var import_neverthrow92 = __toESM(require_index_cjs(), 1);
+var import_promises32 = require("node:fs/promises");
+var import_node_path37 = __toESM(require("node:path"), 1);
+var import_neverthrow93 = __toESM(require_index_cjs(), 1);
 var SUITE_FILE_SUFFIX = ".suite.json";
 var freestyleEntrySchema2 = external_exports.object({
   timeoutSeconds: external_exports.number().int().positive(),
@@ -93421,39 +93489,39 @@ var suiteFileSchema = external_exports.object({
   freestyle: external_exports.array(freestyleEntrySchema2).optional(),
   hooks: external_exports.record(external_exports.string(), external_exports.unknown()).optional()
 });
-var safeJsonParse6 = (0, import_neverthrow92.fromThrowable)(JSON.parse);
+var safeJsonParse6 = (0, import_neverthrow93.fromThrowable)(JSON.parse);
 async function runReadFile(filePath) {
-  return (0, import_promises33.readFile)(filePath, "utf8");
+  return (0, import_promises32.readFile)(filePath, "utf8");
 }
 async function runStat(filePath) {
-  return (0, import_promises33.stat)(filePath);
+  return (0, import_promises32.stat)(filePath);
 }
 async function runReadDirectory(filePath) {
-  return (0, import_promises33.readdir)(filePath);
+  return (0, import_promises32.readdir)(filePath);
 }
 function readSuiteFile(filePath) {
-  const safeRead = import_neverthrow92.ResultAsync.fromThrowable(
+  const safeRead = import_neverthrow93.ResultAsync.fromThrowable(
     runReadFile,
     (cause) => ({ type: "SUITE_READ_FAILED", path: filePath, cause })
   );
   return safeRead(filePath);
 }
 function readSpecFile2(filePath) {
-  const safeRead = import_neverthrow92.ResultAsync.fromThrowable(
+  const safeRead = import_neverthrow93.ResultAsync.fromThrowable(
     runReadFile,
     () => ({ type: "SPEC_NOT_FOUND", path: filePath })
   );
   return safeRead(filePath);
 }
 function statDirectory(directory) {
-  const safeStat = import_neverthrow92.ResultAsync.fromThrowable(
+  const safeStat = import_neverthrow93.ResultAsync.fromThrowable(
     runStat,
     () => ({ type: "SUITE_DIR_MISSING", path: directory })
   );
   return safeStat(directory);
 }
 function readDirectoryEntries(directory) {
-  const safeReadDirectory = import_neverthrow92.ResultAsync.fromThrowable(
+  const safeReadDirectory = import_neverthrow93.ResultAsync.fromThrowable(
     runReadDirectory,
     (cause) => ({ type: "SUITE_READ_FAILED", path: directory, cause })
   );
@@ -93462,34 +93530,34 @@ function readDirectoryEntries(directory) {
 function listSuiteFiles(directory) {
   return statDirectory(directory).andThen((stats) => {
     if (!stats.isDirectory()) {
-      return (0, import_neverthrow92.errAsync)({ type: "SUITE_DIR_MISSING", path: directory });
+      return (0, import_neverthrow93.errAsync)({ type: "SUITE_DIR_MISSING", path: directory });
     }
     return readDirectoryEntries(directory);
   }).map(
-    (entries) => entries.filter((entry) => entry.endsWith(SUITE_FILE_SUFFIX)).map((entry) => import_node_path38.default.resolve(directory, entry)).toSorted()
+    (entries) => entries.filter((entry) => entry.endsWith(SUITE_FILE_SUFFIX)).map((entry) => import_node_path37.default.resolve(directory, entry)).toSorted()
   );
 }
 function parseSuiteFile(filePath, raw) {
   const parsed = safeJsonParse6(raw);
   if (parsed.isErr()) {
-    return (0, import_neverthrow92.err)({ type: "SUITE_INVALID", path: filePath, cause: parsed.error });
+    return (0, import_neverthrow93.err)({ type: "SUITE_INVALID", path: filePath, cause: parsed.error });
   }
   const validated = suiteFileSchema.safeParse(parsed.value);
   if (!validated.success) {
-    return (0, import_neverthrow92.err)({ type: "SUITE_INVALID", path: filePath, cause: validated.error });
+    return (0, import_neverthrow93.err)({ type: "SUITE_INVALID", path: filePath, cause: validated.error });
   }
-  return (0, import_neverthrow92.ok)(validated.data);
+  return (0, import_neverthrow93.ok)(validated.data);
 }
 function suiteIdFromPath(filePath) {
-  const name = import_node_path38.default.basename(filePath);
+  const name = import_node_path37.default.basename(filePath);
   return name.slice(0, name.length - SUITE_FILE_SUFFIX.length);
 }
 function loadSpecReference(xqaDirectory, specPath) {
-  const absolute = import_node_path38.default.resolve(xqaDirectory, specPath);
+  const absolute = import_node_path37.default.resolve(xqaDirectory, specPath);
   return readSpecFile2(absolute).andThen((raw) => {
     const parsed = parseSpecFrontmatter(raw);
     if (parsed.isErr()) {
-      return (0, import_neverthrow92.err)({
+      return (0, import_neverthrow93.err)({
         type: "SPEC_FRONTMATTER_INVALID",
         path: absolute,
         cause: parsed.error.cause
@@ -93497,19 +93565,19 @@ function loadSpecReference(xqaDirectory, specPath) {
     }
     const { feature, timeoutSeconds } = parsed.value;
     if (timeoutSeconds === void 0) {
-      return (0, import_neverthrow92.ok)({ path: specPath, feature });
+      return (0, import_neverthrow93.ok)({ path: specPath, feature });
     }
-    return (0, import_neverthrow92.ok)({ path: specPath, feature, timeoutSeconds });
+    return (0, import_neverthrow93.ok)({ path: specPath, feature, timeoutSeconds });
   });
 }
 function loadSpecReferences(xqaDirectory, specs) {
   if (specs.length === 0) {
-    return (0, import_neverthrow92.okAsync)([]);
+    return (0, import_neverthrow93.okAsync)([]);
   }
-  return import_neverthrow92.ResultAsync.combine(specs.map((specPath) => loadSpecReference(xqaDirectory, specPath)));
+  return import_neverthrow93.ResultAsync.combine(specs.map((specPath) => loadSpecReference(xqaDirectory, specPath)));
 }
 function addSpecTokens(tokens, spec) {
-  const stem = import_node_path38.default.basename(spec.path).replace(/\.test\.md$/u, "");
+  const stem = import_node_path37.default.basename(spec.path).replace(/\.test\.md$/u, "");
   for (const part of stem.split(".")) {
     if (part.length > 0) {
       tokens.add(part);
@@ -93582,12 +93650,12 @@ function loadSuite(suiteFilePath, xqaDirectory) {
   );
 }
 function loadXqaSuites(directory) {
-  const xqaDirectory = import_node_path38.default.dirname(import_node_path38.default.resolve(directory));
+  const xqaDirectory = import_node_path37.default.dirname(import_node_path37.default.resolve(directory));
   return listSuiteFiles(directory).andThen((files) => {
     if (files.length === 0) {
-      return (0, import_neverthrow92.okAsync)([]);
+      return (0, import_neverthrow93.okAsync)([]);
     }
-    return import_neverthrow92.ResultAsync.combine(files.map((file2) => loadSuite(file2, xqaDirectory)));
+    return import_neverthrow93.ResultAsync.combine(files.map((file2) => loadSuite(file2, xqaDirectory)));
   });
 }
 
@@ -93598,27 +93666,27 @@ function parseRepo(input) {
   const parts = input.split("/");
   const [owner, repo] = parts;
   if (parts.length !== 2 || owner === void 0 || owner === "" || repo === void 0 || repo === "") {
-    return (0, import_neverthrow93.err)({ type: "CLI_INVALID_ARG", message: `invalid --repo value: ${input}` });
+    return (0, import_neverthrow94.err)({ type: "CLI_INVALID_ARG", message: `invalid --repo value: ${input}` });
   }
-  return (0, import_neverthrow93.ok)({ owner, repo });
+  return (0, import_neverthrow94.ok)({ owner, repo });
 }
 function parsePrNumber(input) {
   const parsed = Number.parseInt(input, 10);
   if (!Number.isFinite(parsed) || parsed <= 0) {
-    return (0, import_neverthrow93.err)({ type: "CLI_INVALID_ARG", message: `invalid --pr value: ${input}` });
+    return (0, import_neverthrow94.err)({ type: "CLI_INVALID_ARG", message: `invalid --pr value: ${input}` });
   }
-  return (0, import_neverthrow93.ok)(parsed);
+  return (0, import_neverthrow94.ok)(parsed);
 }
 function parseCliInputs(options2) {
   const repoResult = parseRepo(options2.repo);
   if (repoResult.isErr()) {
-    return (0, import_neverthrow93.err)(repoResult.error);
+    return (0, import_neverthrow94.err)(repoResult.error);
   }
   const prResult = parsePrNumber(options2.pr);
   if (prResult.isErr()) {
-    return (0, import_neverthrow93.err)(prResult.error);
+    return (0, import_neverthrow94.err)(prResult.error);
   }
-  return (0, import_neverthrow93.ok)({
+  return (0, import_neverthrow94.ok)({
     owner: repoResult.value.owner,
     repo: repoResult.value.repo,
     prNumber: prResult.value
@@ -93626,23 +93694,23 @@ function parseCliInputs(options2) {
 }
 function resolveGithubToken(context) {
   if (!context.rootConfig.agents.triager.enabled) {
-    return (0, import_neverthrow93.err)({ type: "TRIAGER_DISABLED" });
+    return (0, import_neverthrow94.err)({ type: "TRIAGER_DISABLED" });
   }
   if (context.config.GITHUB_TOKEN === void 0) {
-    return (0, import_neverthrow93.err)({ type: "CONFIG_MISSING", key: "GITHUB_TOKEN" });
+    return (0, import_neverthrow94.err)({ type: "CONFIG_MISSING", key: "GITHUB_TOKEN" });
   }
-  return (0, import_neverthrow93.ok)(context.config.GITHUB_TOKEN);
+  return (0, import_neverthrow94.ok)(context.config.GITHUB_TOKEN);
 }
 function buildInputs(options2, context) {
   const tokenResult = resolveGithubToken(context);
   if (tokenResult.isErr()) {
-    return (0, import_neverthrow93.err)(tokenResult.error);
+    return (0, import_neverthrow94.err)(tokenResult.error);
   }
   const parsed = parseCliInputs(options2);
   if (parsed.isErr()) {
-    return (0, import_neverthrow93.err)(parsed.error);
+    return (0, import_neverthrow94.err)(parsed.error);
   }
-  return (0, import_neverthrow93.ok)({
+  return (0, import_neverthrow94.ok)({
     owner: parsed.value.owner,
     repo: parsed.value.repo,
     prNumber: parsed.value.prNumber,
@@ -93670,7 +93738,7 @@ function callTriager(options2) {
 }
 function maybeApplyLabels(inputs, labels) {
   if (!inputs.applyLabels || labels.length === 0) {
-    return import_neverthrow93.ResultAsync.fromSafePromise(Promise.resolve(labels));
+    return import_neverthrow94.ResultAsync.fromSafePromise(Promise.resolve(labels));
   }
   return applyPullRequestLabels({
     owner: inputs.owner,
@@ -93681,7 +93749,7 @@ function maybeApplyLabels(inputs, labels) {
   }).map(() => labels);
 }
 function runPipeline5(inputs) {
-  return import_neverthrow93.ResultAsync.combine([
+  return import_neverthrow94.ResultAsync.combine([
     loadXqaSuites(inputs.suitesDir),
     fetchPullRequestDiff({
       owner: inputs.owner,
@@ -93775,10 +93843,10 @@ var rootConfigSchema = external_exports.object({
 }).strict();
 
 // src/config.ts
-var import_node_path39 = __toESM(require("node:path"), 1);
+var import_node_path38 = __toESM(require("node:path"), 1);
 var import_node_url2 = require("node:url");
 var import_dotenv = __toESM(require_main(), 1);
-var import_neverthrow94 = __toESM(require_index_cjs(), 1);
+var import_neverthrow95 = __toESM(require_index_cjs(), 1);
 
 // src/config-schema.ts
 var configSchema = external_exports.object({
@@ -93788,23 +93856,23 @@ var configSchema = external_exports.object({
 });
 
 // src/config.ts
-var packageDirectory = import_node_path39.default.dirname((0, import_node_url2.fileURLToPath)(__importMetaUrl));
+var packageDirectory = import_node_path38.default.dirname((0, import_node_url2.fileURLToPath)(__importMetaUrl));
 function loadConfig2() {
-  (0, import_dotenv.config)({ path: import_node_path39.default.resolve(packageDirectory, "..", ".env.local") });
+  (0, import_dotenv.config)({ path: import_node_path38.default.resolve(packageDirectory, "..", ".env.local") });
   const result = configSchema.safeParse(process.env);
   if (!result.success) {
     const messages = result.error.issues.map(
       (issue2) => `  - ${issue2.path.join(".")}: ${issue2.message}`
     );
-    return (0, import_neverthrow94.err)({ type: "INVALID_CONFIG", message: `Configuration error:
+    return (0, import_neverthrow95.err)({ type: "INVALID_CONFIG", message: `Configuration error:
 ${messages.join("\n")}` });
   }
-  return (0, import_neverthrow94.ok)(result.data);
+  return (0, import_neverthrow95.ok)(result.data);
 }
 
 // src/pid-lock.ts
 var import_node_fs13 = require("node:fs");
-var import_neverthrow95 = __toESM(require_index_cjs(), 1);
+var import_neverthrow96 = __toESM(require_index_cjs(), 1);
 var PID_FILE = "/tmp/xqa.pid";
 var SIGINT_EXIT_CODE = 130;
 var SIGTERM_EXIT_CODE = 143;
@@ -93813,7 +93881,7 @@ var HARD_TIMEOUT_MS = 1e4;
 var cleanup = () => {
   (0, import_node_fs13.rmSync)(PID_FILE, { force: true });
 };
-var checkProcessRunning = (0, import_neverthrow95.fromThrowable)(
+var checkProcessRunning = (0, import_neverthrow96.fromThrowable)(
   (pid) => {
     process.kill(pid, 0);
     return true;
@@ -93880,17 +93948,16 @@ function acquireLock() {
 function loadCliContext(signal) {
   const configResult = loadConfig2();
   if (configResult.isErr()) {
-    return (0, import_neverthrow96.err)(configResult.error);
+    return (0, import_neverthrow97.err)(configResult.error);
   }
   const rootConfigResult = loadConfigSync({
     cwd: process.cwd(),
-    schema: rootConfigSchema,
-    env: process.env
+    schema: rootConfigSchema
   });
   if (rootConfigResult.isErr()) {
-    return (0, import_neverthrow96.err)(rootConfigResult.error);
+    return (0, import_neverthrow97.err)(rootConfigResult.error);
   }
-  return (0, import_neverthrow96.ok)({
+  return (0, import_neverthrow97.ok)({
     config: configResult.value,
     rootConfig: rootConfigResult.value,
     signal
@@ -93922,7 +93989,7 @@ function buildProgram(options2) {
 
 // src/index.ts
 process.title = "xqa";
-var version2 = `${"4.0.0"}${false ? ` (dev build +${"53b713f"})` : ""}`;
+var version2 = `${"5.1.0"}${false ? ` (dev build +${"7bb7ba0"})` : ""}`;
 var program2 = buildProgram({ version: version2 });
 void program2.parseAsync(process.argv);
 /*! Bundled license information: