codeloop-mcp-server 0.1.53 → 0.1.55

package/dist/runners/modal_close_strategies.d.ts

@@ -0,0 +1,82 @@
+import { type ModalDetectionResult } from "./modal_detector.js";
+/**
+ * 0.1.54 E1 — Multi-strategy modal close.
+ *
+ * Photometry-DB E2E #11 transcript shipped at 100% confidence after the
+ * agent had to HARD-RESTART the app process to drain a stack of three
+ * .NET 8 OpenFolderDialog instances that ignored every close attempt
+ * codeloop_handle_modal made (`WM_CLOSE` / `SC_CLOSE` / focused-Escape).
+ * The pre-0.1.54 handler only sent `Enter` / `Escape` keystrokes — when
+ * a Win32 file dialog stops responding to those (which it does after
+ * being stacked), the loop had no fallback path.
+ *
+ * This module ships a 4-step ladder, executed in order with re-detection
+ * after each step. Stops as soon as detectModal returns is_modal_present:
+ * false. Returns the full sequence of attempts so the agent (and the
+ * cycle_issues evidence channel from E2) can audit which strategy worked
+ * or whether the kill-window escalation is required.
+ *
+ * Strategies:
+ *   1. focused Escape (current 0.1.51 behaviour — works for most simple
+ *      WPF / WinForms confirmation dialogs).
+ *   2. Alt+F4 against the foreground window — closes file dialogs that
+ *      have rejected Escape because they're waiting on a button click.
+ *   3. UIA InvokePattern on the dialog's "Close" button — handles file
+ *      dialogs whose top-right X is technically a button, not a window
+ *      caption click.
+ *   4. Win32 EndDialog(hwnd, IDCANCEL) via Add-Type — last resort before
+ *      kill-window. Works for true MODAL dialogs even when the message
+ *      pump is wedged.
+ *
+ * If all 4 fail the caller surfaces the kill-window escalation; the
+ * separate `codeloop_kill_modal_window` tool sends WM_CLOSE to the
+ * specific HWND, then TerminateProcess if the dialog is still up
+ * after a 2 s grace period.
+ */
+export type StrategyName = "escape" | "alt_f4" | "uia_invoke_close" | "end_dialog";
+export interface StrategyAttempt {
+    strategy: StrategyName;
+    success: boolean;
+    error?: string;
+}
+export interface MultiStrategyCloseResult {
+    closed: boolean;
+    strategies_tried: StrategyAttempt[];
+    /** Modal description as reported by the LAST detectModal probe. */
+    final_detection: ModalDetectionResult;
+    /** When closed=false, the agent should escalate via codeloop_kill_modal_window. */
+    escalation: "none" | "kill_window_required";
+    /** HWND captured at first detection, used by kill-window escalation. */
+    hwnd?: string;
+}
+/**
+ * Run the strategy ladder against the detected modal. Re-detects after
+ * each step. Caller is expected to have already called detectModal and
+ * confirmed `is_modal_present: true`.
+ */
+export declare function closeModalWithStrategies(opts: {
+    initial_detection: ModalDetectionResult;
+    app_name?: string;
+    cwd: string;
+}): Promise<MultiStrategyCloseResult>;
+/**
+ * 0.1.54 E1 — last-resort kill: PostMessage(WM_CLOSE) to the HWND, wait
+ * 2 s, re-detect, and if the modal is still up TerminateProcess on the
+ * owning process. Used by codeloop_kill_modal_window when the strategy
+ * ladder gives up.
+ */
+export interface KillModalWindowResult {
+    closed: boolean;
+    steps: Array<{
+        step: "post_wm_close" | "terminate_process";
+        success: boolean;
+        error?: string;
+    }>;
+    final_detection: ModalDetectionResult;
+}
+export declare function killModalWindow(opts: {
+    hwnd: string;
+    app_name?: string;
+    cwd: string;
+}): Promise<KillModalWindowResult>;
+//# sourceMappingURL=modal_close_strategies.d.ts.map

package/dist/runners/modal_close_strategies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modal_close_strategies.d.ts","sourceRoot":"","sources":["../../src/runners/modal_close_strategies.ts"],"names":[],"mappings":"AACA,OAAO,EAAe,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,kBAAkB,GAAG,YAAY,CAAC;AAEnF,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,OAAO,CAAC;IAChB,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,mEAAmE;IACnE,eAAe,EAAE,oBAAoB,CAAC;IACtC,mFAAmF;IACnF,UAAU,EAAE,MAAM,GAAG,sBAAsB,CAAC;IAC5C,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAoGD;;;;GAIG;AACH,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,iBAAiB,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAyEpC;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,eAAe,GAAG,mBAAmB,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChG,eAAe,EAAE,oBAAoB,CAAC;CACvC;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAqEjC"}

package/dist/runners/modal_close_strategies.js

@@ -0,0 +1,226 @@
+import { runCommand } from "./base.js";
+import { detectModal } from "./modal_detector.js";
+const RE_DETECT_DELAY_MS = 400;
+async function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function pressEscapeWindows(cwd) {
+    // SendKeys-based — focused window receives Escape. Mirrors what
+    // codeloop_interact action="keystroke", key="escape" does.
+    const script = [
+        "Add-Type -AssemblyName System.Windows.Forms",
+        "[System.Windows.Forms.SendKeys]::SendWait('{ESC}')",
+    ].join("\n");
+    const r = await runCommand("powershell", ["-NoProfile", "-Command", script], cwd, undefined, undefined, 5000);
+    return r.exit_code === 0 ? { ok: true } : { ok: false, err: r.stderr.slice(0, 200) };
+}
+async function pressAltF4Windows(cwd) {
+    const script = [
+        "Add-Type -AssemblyName System.Windows.Forms",
+        "[System.Windows.Forms.SendKeys]::SendWait('%{F4}')",
+    ].join("\n");
+    const r = await runCommand("powershell", ["-NoProfile", "-Command", script], cwd, undefined, undefined, 5000);
+    return r.exit_code === 0 ? { ok: true } : { ok: false, err: r.stderr.slice(0, 200) };
+}
+async function uiaInvokeCloseButtonWindows(cwd, hwnd) {
+    // Walk the modal window's children looking for a button named "Close",
+    // "Cancel", or "X". When hwnd is provided we can target the dialog
+    // directly via FromHandle; otherwise fall back to the foreground
+    // window via NativeWindowHandle property.
+    const handleArg = hwnd ?? "$null";
+    const script = [
+        "Add-Type -AssemblyName UIAutomationClient",
+        `$hwnd = ${handleArg}`,
+        "if ($hwnd -ne $null -and $hwnd -ne 0) {",
+        "  $w = [System.Windows.Automation.AutomationElement]::FromHandle([IntPtr]$hwnd)",
+        "} else {",
+        "  $root = [System.Windows.Automation.AutomationElement]::RootElement",
+        "  $cond = New-Object System.Windows.Automation.PropertyCondition([System.Windows.Automation.AutomationElement]::ControlTypeProperty, [System.Windows.Automation.ControlType]::Window)",
+        "  $w = $root.FindFirst([System.Windows.Automation.TreeScope]::Children, $cond)",
+        "}",
+        "if ($w -eq $null) { Write-Error 'no window found'; exit 1 }",
+        "$btnCond = New-Object System.Windows.Automation.PropertyCondition([System.Windows.Automation.AutomationElement]::ControlTypeProperty, [System.Windows.Automation.ControlType]::Button)",
+        "$buttons = $w.FindAll([System.Windows.Automation.TreeScope]::Subtree, $btnCond)",
+        "$invoked = $false",
+        "foreach ($b in $buttons) {",
+        "  $name = $b.Current.Name",
+        "  if ($name -match '^(Close|Cancel|X|Dismiss)$') {",
+        "    try {",
+        "      $invoke = $b.GetCurrentPattern([System.Windows.Automation.InvokePattern]::Pattern)",
+        "      $invoke.Invoke()",
+        "      $invoked = $true",
+        "      break",
+        "    } catch { }",
+        "  }",
+        "}",
+        "if (-not $invoked) { Write-Error 'no close button found'; exit 1 }",
+    ].join("\n");
+    const r = await runCommand("powershell", ["-NoProfile", "-Command", script], cwd, undefined, undefined, 8000);
+    return r.exit_code === 0 ? { ok: true } : { ok: false, err: r.stderr.slice(0, 200) };
+}
+async function endDialogWindows(cwd, hwnd) {
+    if (!hwnd) {
+        return { ok: false, err: "EndDialog requires hwnd; detector did not capture one" };
+    }
+    // EndDialog Win32 call. Falls back to PostMessage(WM_CLOSE) when the
+    // window isn't a true dialog (EndDialog returns FALSE in that case but
+    // PostMessage can still terminate it).
+    const script = [
+        "Add-Type @\"",
+        "using System;",
+        "using System.Runtime.InteropServices;",
+        "public class CL {",
+        "  [DllImport(\"user32.dll\")] public static extern bool EndDialog(IntPtr hDlg, IntPtr nResult);",
+        "  [DllImport(\"user32.dll\")] public static extern bool PostMessage(IntPtr hWnd, uint Msg, IntPtr wParam, IntPtr lParam);",
+        "}",
+        "\"@",
+        `$hwnd = [IntPtr]${hwnd}`,
+        "$ok = [CL]::EndDialog($hwnd, [IntPtr]2)",
+        // 2 == IDCANCEL
+        "if (-not $ok) {",
+        "  $WM_CLOSE = 0x0010",
+        "  $ok2 = [CL]::PostMessage($hwnd, $WM_CLOSE, [IntPtr]::Zero, [IntPtr]::Zero)",
+        "  if (-not $ok2) { Write-Error 'EndDialog and PostMessage(WM_CLOSE) both failed'; exit 1 }",
+        "}",
+    ].join("\n");
+    const r = await runCommand("powershell", ["-NoProfile", "-Command", script], cwd, undefined, undefined, 5000);
+    return r.exit_code === 0 ? { ok: true } : { ok: false, err: r.stderr.slice(0, 200) };
+}
+/**
+ * Run the strategy ladder against the detected modal. Re-detects after
+ * each step. Caller is expected to have already called detectModal and
+ * confirmed `is_modal_present: true`.
+ */
+export async function closeModalWithStrategies(opts) {
+    const { initial_detection: initial, app_name, cwd } = opts;
+    const hwnd = initial.hwnd;
+    const attempts = [];
+    const stepDispatch = {
+        escape: () => pressEscapeWindows(cwd),
+        alt_f4: () => pressAltF4Windows(cwd),
+        uia_invoke_close: () => uiaInvokeCloseButtonWindows(cwd, hwnd),
+        end_dialog: () => endDialogWindows(cwd, hwnd),
+    };
+    // 0.1.54 E1 — strategy order: cheap-and-fast first, expensive last.
+    // For confirm/alert kinds we don't really need Alt+F4 or EndDialog
+    // (they bias toward 'confirm' rather than 'cancel'), but the ladder
+    // is still safe to run because we re-detect between steps.
+    const ladder = ["escape", "alt_f4", "uia_invoke_close", "end_dialog"];
+    let lastDetection = initial;
+    for (const strategy of ladder) {
+        if (process.platform !== "win32") {
+            // Non-Windows desktop modal handling stays at the 0.1.51 single-
+            // keystroke behaviour because macOS / Linux modals don't show
+            // the same OpenFolderDialog stuck-stack problem. Surface that
+            // limitation explicitly so the caller doesn't get confused.
+            attempts.push({
+                strategy,
+                success: false,
+                error: "multi-strategy close ladder is Windows-only; macOS/Linux fall back to keystroke",
+            });
+            break;
+        }
+        const r = await stepDispatch[strategy]();
+        attempts.push({
+            strategy,
+            success: r.ok,
+            error: r.err,
+        });
+        if (!r.ok)
+            continue;
+        // Re-detect. If the modal is gone, we're done.
+        await sleep(RE_DETECT_DELAY_MS);
+        lastDetection = await detectModal({
+            target_type: "desktop",
+            app_name,
+            cwd,
+        });
+        if (!lastDetection.is_modal_present) {
+            return {
+                closed: true,
+                strategies_tried: attempts,
+                final_detection: lastDetection,
+                escalation: "none",
+                hwnd,
+            };
+        }
+        // If the HWND changed (modal stack drained one level), keep going
+        // through the ladder against the next-up modal — but cap the loop
+        // by exhausting our 4 strategies. The next call to handle_modal
+        // will pick up any remaining stacked modal.
+    }
+    return {
+        closed: false,
+        strategies_tried: attempts,
+        final_detection: lastDetection,
+        escalation: "kill_window_required",
+        hwnd,
+    };
+}
+export async function killModalWindow(opts) {
+    if (process.platform !== "win32") {
+        return {
+            closed: false,
+            steps: [
+                {
+                    step: "post_wm_close",
+                    success: false,
+                    error: "kill-window escalation is Windows-only",
+                },
+            ],
+            final_detection: { is_modal_present: false, target_type: "desktop" },
+        };
+    }
+    const steps = [];
+    // Step 1: PostMessage(WM_CLOSE).
+    const wmCloseScript = [
+        "Add-Type @\"",
+        "using System;",
+        "using System.Runtime.InteropServices;",
+        "public class CL2 {",
+        "  [DllImport(\"user32.dll\")] public static extern bool PostMessage(IntPtr hWnd, uint Msg, IntPtr wParam, IntPtr lParam);",
+        "  [DllImport(\"user32.dll\")] public static extern uint GetWindowThreadProcessId(IntPtr hWnd, out uint lpdwProcessId);",
+        "}",
+        "\"@",
+        `$hwnd = [IntPtr]${opts.hwnd}`,
+        "$WM_CLOSE = 0x0010",
+        "$ok = [CL2]::PostMessage($hwnd, $WM_CLOSE, [IntPtr]::Zero, [IntPtr]::Zero)",
+        "if (-not $ok) { Write-Error 'PostMessage(WM_CLOSE) failed'; exit 1 }",
+    ].join("\n");
+    const r1 = await runCommand("powershell", ["-NoProfile", "-Command", wmCloseScript], opts.cwd, undefined, undefined, 5000);
+    steps.push({ step: "post_wm_close", success: r1.exit_code === 0, error: r1.exit_code === 0 ? undefined : r1.stderr.slice(0, 200) });
+    await sleep(2000);
+    let detection = await detectModal({
+        target_type: "desktop",
+        app_name: opts.app_name,
+        cwd: opts.cwd,
+    });
+    if (!detection.is_modal_present) {
+        return { closed: true, steps, final_detection: detection };
+    }
+    // Step 2: TerminateProcess on the owning PID.
+    const terminateScript = [
+        "Add-Type @\"",
+        "using System;",
+        "using System.Runtime.InteropServices;",
+        "public class CL3 {",
+        "  [DllImport(\"user32.dll\")] public static extern uint GetWindowThreadProcessId(IntPtr hWnd, out uint lpdwProcessId);",
+        "}",
+        "\"@",
+        `$hwnd = [IntPtr]${opts.hwnd}`,
+        "$pid_out = 0",
+        "[void][CL3]::GetWindowThreadProcessId($hwnd, [ref]$pid_out)",
+        "if ($pid_out -eq 0) { Write-Error 'could not resolve PID for HWND'; exit 1 }",
+        "Stop-Process -Id $pid_out -Force",
+    ].join("\n");
+    const r2 = await runCommand("powershell", ["-NoProfile", "-Command", terminateScript], opts.cwd, undefined, undefined, 5000);
+    steps.push({ step: "terminate_process", success: r2.exit_code === 0, error: r2.exit_code === 0 ? undefined : r2.stderr.slice(0, 200) });
+    await sleep(1000);
+    detection = await detectModal({
+        target_type: "desktop",
+        app_name: opts.app_name,
+        cwd: opts.cwd,
+    });
+    return { closed: !detection.is_modal_present, steps, final_detection: detection };
+}
+//# sourceMappingURL=modal_close_strategies.js.map

package/dist/runners/modal_close_strategies.js.map

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

package/dist/runners/modal_detector.d.ts

@@ -32,10 +32,25 @@ import type { CodeLoopConfig } from "@codelooptech/shared";
  * negative as proof there's no modal — the post-interact directive
  * (layer 3) covers that case by always nudging the agent to look.
  */
+/**
+ * 0.1.54 E1 — modal_kind classifies the detected modal so codeloop_handle_modal
+ * can pick the right close strategy. .NET 8 OpenFolderDialog / OpenFileDialog
+ * are the dominant "stuck" modal class — Photometry-DB E2E #11 had three
+ * stacked file dialogs that ignored every close attempt the handler tried.
+ * "file_dialog" routes them through the multi-strategy close ladder
+ * (Escape → Alt+F4 → UIA Invoke "Close" → EndDialog → kill-window).
+ */
+export type ModalKind = "file_dialog" | "confirm" | "alert" | "custom";
 export interface ModalDetectionResult {
     is_modal_present: boolean;
     /** Human-readable description of the detected modal, when present. */
     modal_description?: string;
+    /** 0.1.54 E1 — classification used by codeloop_handle_modal to pick close strategy. */
+    modal_kind?: ModalKind;
+    /** 0.1.54 E1 — Win32 HWND when available, used by codeloop_kill_modal_window. */
+    hwnd?: string;
+    /** 0.1.54 E1 — UIA ClassName when available (e.g. #32770 for Win32 dialogs). */
+    class_name?: string;
     /** Suggested action for the agent: "confirm" | "cancel" | "dismiss" | "inspect". */
     suggested_action?: string;
     /** Heuristic confidence 0-1; > 0.7 should be acted on. */
@@ -45,6 +60,8 @@ export interface ModalDetectionResult {
     /** target_type the detector ran against. */
     target_type: "browser" | "desktop" | "android_emulator" | "ios_simulator" | "unknown";
 }
+/** 0.1.54 E1 — exported so codeloop_handle_modal can reuse the same heuristic. */
+export declare function classifyModalKind(name: string, className?: string): ModalKind;
 export declare function detectModal(opts: {
     target_type?: "browser" | "desktop" | "android_emulator" | "ios_simulator";
     app_name?: string;

package/dist/runners/modal_detector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"modal_detector.d.ts","sourceRoot":"","sources":["../../src/runners/modal_detector.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+FAA+F;IAC/F,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4CAA4C;IAC5C,WAAW,EAAE,SAAS,GAAG,SAAS,GAAG,kBAAkB,GAAG,eAAe,GAAG,SAAS,CAAC;CACvF;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,WAAW,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,kBAAkB,GAAG,eAAe,CAAC;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAiBhC;AA6ID;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAiB5D"}
+{"version":3,"file":"modal_detector.d.ts","sourceRoot":"","sources":["../../src/runners/modal_detector.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH;;;;;;;GAOG;AACH,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEvE,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uFAAuF;IACvF,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+FAA+F;IAC/F,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4CAA4C;IAC5C,WAAW,EAAE,SAAS,GAAG,SAAS,GAAG,kBAAkB,GAAG,eAAe,GAAG,SAAS,CAAC;CACvF;AAqBD,kFAAkF;AAClF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAO7E;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,WAAW,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,kBAAkB,GAAG,eAAe,CAAC;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAiBhC;AAyLD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAiB5D"}

package/dist/runners/modal_detector.js

@@ -1,4 +1,35 @@
 import { runCommand } from "./base.js";
+/**
+ * 0.1.54 E1 — Class names that identify file dialogs across .NET / Win32:
+ *   - `#32770` — every Win32 common dialog (CommonItemDialog included)
+ *   - `Shell_Dialog` — Shell-based file pickers
+ *   - `DirectUIHWND` — child of file dialogs but useful for ownership match
+ *   - `WinUIDesktopWin32WindowClass` — WinUI 3 / .NET 8 desktop
+ *
+ * Name patterns that match file-dialog titles in EN locale; we accept any
+ * substring so localised "Open File" / "Save As" / "Browse Folder" still hit.
+ */
+const FILE_DIALOG_CLASS_NAMES = ["#32770", "Shell_Dialog", "DirectUIHWND", "WinUIDesktopWin32WindowClass"];
+const FILE_DIALOG_NAME_PATTERNS = [
+    /\b(open|save|select|browse|choose)\b.*\b(file|folder|directory|location)\b/i,
+    /\bfile\s*open\b/i,
+    /\bsave\s*as\b/i,
+    /\bopenfolderdialog\b/i,
+    /\bopenfiledialog\b/i,
+];
+/** 0.1.54 E1 — exported so codeloop_handle_modal can reuse the same heuristic. */
+export function classifyModalKind(name, className) {
+    const cls = (className ?? "").trim();
+    if (FILE_DIALOG_CLASS_NAMES.includes(cls))
+        return "file_dialog";
+    if (FILE_DIALOG_NAME_PATTERNS.some((re) => re.test(name)))
+        return "file_dialog";
+    if (/\b(confirm|are you sure|delete\?|discard)\b/i.test(name))
+        return "confirm";
+    if (/\b(error|warning|alert|attention)\b/i.test(name))
+        return "alert";
+    return "custom";
+}
 export async function detectModal(opts) {
     const target = opts.target_type ?? "desktop";
     try {
@@ -42,10 +73,12 @@ async function detectDesktopModal(opts) {
 }
 async function detectWindowsModal(opts) {
     const app = opts.app_name ?? "";
-    const filterClause = app
-        ? `if ($name -notlike '*' + '${app.replace(/'/g, "''")}' + '*') { continue }`
-        : "";
-    // PowerShell UIA probe. Returns JSON the agent can parse.
+    const appLower = app.toLowerCase();
+    // PowerShell UIA probe. 0.1.54 E1 — also collects ClassName + HWND so
+    // codeloop_handle_modal can pick the right close strategy and so the
+    // kill-window escalation knows which window to terminate. We additionally
+    // accept windows that are NOT marked IsModal=true but match a file-dialog
+    // class name (.NET 8 OpenFolderDialog often does not set IsModal).
     const script = [
         "Add-Type -AssemblyName UIAutomationClient",
         "$root = [System.Windows.Automation.AutomationElement]::RootElement",
@@ -54,15 +87,14 @@ async function detectWindowsModal(opts) {
         "$result = @()",
         "foreach ($w in $windows) {",
         "  $name = $w.Current.Name",
-        "  $owned = $false",
+        "  $cls = $w.Current.ClassName",
+        "  $hwnd = $w.Current.NativeWindowHandle",
+        "  $isModal = $false",
         "  try {",
         "    $pattern = $w.GetCurrentPattern([System.Windows.Automation.WindowPattern]::Pattern)",
-        "    $owned = $pattern.Current.IsModal",
+        "    $isModal = $pattern.Current.IsModal",
         "  } catch { }",
-        "  " + filterClause,
-        "  if ($owned) {",
-        "    $result += @{ name = $name; modal = $true }",
-        "  }",
+        "  $result += @{ name = $name; class_name = $cls; hwnd = $hwnd; is_modal = $isModal }",
         "}",
         "$result | ConvertTo-Json -Compress",
     ].join("\n");
@@ -74,22 +106,63 @@ async function detectWindowsModal(opts) {
             detection_error: r.stderr.slice(0, 200),
         };
     }
+    let arr = [];
     try {
         const parsed = r.stdout.trim() ? JSON.parse(r.stdout) : null;
-        const arr = Array.isArray(parsed) ? parsed : parsed ? [parsed] : [];
-        const modal = arr.find((w) => w.modal);
-        if (modal) {
-            return {
-                is_modal_present: true,
-                modal_description: `Windows modal: ${modal.name ?? "(unnamed)"}`,
-                suggested_action: "inspect",
-                confidence: 0.85,
-                target_type: "desktop",
-            };
-        }
+        arr = Array.isArray(parsed) ? parsed : parsed ? [parsed] : [];
     }
     catch {
-        /* fall through */
+        return { is_modal_present: false, target_type: "desktop" };
+    }
+    // First pass: explicitly modal windows that pass the app filter.
+    // Second pass: file-dialog class match (regardless of IsModal flag) when
+    // the window's name suggests a file picker. The two-pass split makes sure
+    // we never spuriously match an unrelated #32770 dialog the OS itself owns
+    // (Windows Spotlight, Snipping Tool, etc.) — the file-dialog match
+    // requires either a name pattern OR an app filter that hits the running
+    // process.
+    const matchesAppFilter = (name) => {
+        if (!appLower)
+            return true;
+        return name.toLowerCase().includes(appLower);
+    };
+    const explicit = arr.find((w) => w.is_modal && matchesAppFilter(w.name ?? ""));
+    if (explicit) {
+        const name = explicit.name ?? "(unnamed)";
+        const cls = explicit.class_name ?? undefined;
+        return {
+            is_modal_present: true,
+            modal_description: `Windows modal: ${name}`,
+            modal_kind: classifyModalKind(name, cls),
+            class_name: cls,
+            hwnd: explicit.hwnd != null ? String(explicit.hwnd) : undefined,
+            suggested_action: "inspect",
+            confidence: 0.85,
+            target_type: "desktop",
+        };
+    }
+    const fileDialog = arr.find((w) => {
+        const name = w.name ?? "";
+        const cls = w.class_name ?? "";
+        if (!FILE_DIALOG_CLASS_NAMES.includes(cls))
+            return false;
+        // The app filter applies for class-only matches — without it any Win32
+        // dialog on the desktop would trigger.
+        return matchesAppFilter(name) || FILE_DIALOG_NAME_PATTERNS.some((re) => re.test(name));
+    });
+    if (fileDialog) {
+        const name = fileDialog.name ?? "(unnamed)";
+        const cls = fileDialog.class_name ?? undefined;
+        return {
+            is_modal_present: true,
+            modal_description: `Windows file dialog: ${name}`,
+            modal_kind: "file_dialog",
+            class_name: cls,
+            hwnd: fileDialog.hwnd != null ? String(fileDialog.hwnd) : undefined,
+            suggested_action: "dismiss",
+            confidence: 0.75,
+            target_type: "desktop",
+        };
     }
     return { is_modal_present: false, target_type: "desktop" };
 }

package/dist/runners/modal_detector.js.map

@@ -1 +1 @@
-{"version":3,"file":"modal_detector.js","sourceRoot":"","sources":["../../src/runners/modal_detector.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"modal_detector.js","sourceRoot":"","sources":["../../src/runners/modal_detector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAmEvC;;;;;;;;;GASG;AACH,MAAM,uBAAuB,GAAG,CAAC,QAAQ,EAAE,cAAc,EAAE,cAAc,EAAE,8BAA8B,CAAC,CAAC;AAC3G,MAAM,yBAAyB,GAAG;IAChC,6EAA6E;IAC7E,kBAAkB;IAClB,gBAAgB;IAChB,uBAAuB;IACvB,qBAAqB;CACtB,CAAC;AAEF,kFAAkF;AAClF,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,SAAkB;IAChE,MAAM,GAAG,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACrC,IAAI,uBAAuB,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,aAAa,CAAC;IAChE,IAAI,yBAAyB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,aAAa,CAAC;IAChF,IAAI,8CAA8C,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAChF,IAAI,sCAAsC,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,OAAO,CAAC;IACtE,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAKjC;IACC,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,IAAI,SAAS,CAAC;IAC7C,IAAI,CAAC;QACH,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAChE,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAChE,OAAO;YACL,gBAAgB,EAAE,KAAK;YACvB,WAAW,EAAE,MAAM;YACnB,eAAe,EAAE,sBAAsB,MAAM,wFAAwF;SACtI,CAAC;IACJ,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO;YACL,gBAAgB,EAAE,KAAK;YACvB,WAAW,EAAE,MAAM;YACnB,eAAe,EAAG,CAAW,CAAC,OAAO;SACtC,CAAC;IACJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,KAEjC;IACC,kEAAkE;IAClE,gEAAgE;IAChE,2DAA2D;IAC3D,iEAAiE;IACjE,4DAA4D;IAC5D,qBAAqB;IACrB,OAAO;QACL,gBAAgB,EAAE,KAAK;QACvB,WAAW,EAAE,SAAS;QACtB,eAAe,EACb,0OAA0O;KAC7O,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,IAGjC;IACC,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAClE,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;IAC/D,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,IAGjC;IACC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;IAChC,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IACnC,sEAAsE;IACtE,qEAAqE;IACrE,0EAA0E;IAC1E,0EAA0E;IAC1E,mEAAmE;IACnE,MAAM,MAAM,GAAG;QACb,2CAA2C;QAC3C,oEAAoE;QACpE,qLAAqL;QACrL,kFAAkF;QAClF,eAAe;QACf,4BAA4B;QAC5B,2BAA2B;QAC3B,+BAA+B;QAC/B,yCAAyC;QACzC,qBAAqB;QACrB,SAAS;QACT,yFAAyF;QACzF,yCAAyC;QACzC,eAAe;QACf,sFAAsF;QACtF,GAAG;QACH,oCAAoC;KACrC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,MAAM,CAAC,GAAG,MAAM,UAAU,CAAC,YAAY,EAAE,CAAC,YAAY,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IACnH,IAAI,CAAC,CAAC,SAAS,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO;YACL,gBAAgB,EAAE,KAAK;YACvB,WAAW,EAAE,SAAS;YACtB,eAAe,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;SACxC,CAAC;IACJ,CAAC;IACD,IAAI,GAAG,GAA8F,EAAE,CAAC;IACxG,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7D,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;IAC7D,CAAC;IAED,iEAAiE;IACjE,yEAAyE;IACzE,0EAA0E;IAC1E,0EAA0E;IAC1E,mEAAmE;IACnE,wEAAwE;IACxE,WAAW;IACX,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAW,EAAE;QACjD,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC3B,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,IAAI,gBAAgB,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;IAC/E,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,IAAI,WAAW,CAAC;QAC1C,MAAM,GAAG,GAAG,QAAQ,CAAC,UAAU,IAAI,SAAS,CAAC;QAC7C,OAAO;YACL,gBAAgB,EAAE,IAAI;YACtB,iBAAiB,EAAE,kBAAkB,IAAI,EAAE;YAC3C,UAAU,EAAE,iBAAiB,CAAC,IAAI,EAAE,GAAG,CAAC;YACxC,UAAU,EAAE,GAAG;YACf,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;YAC/D,gBAAgB,EAAE,SAAS;YAC3B,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,SAAS;SACvB,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;QAChC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC;QAC/B,IAAI,CAAC,uBAAuB,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QACzD,uEAAuE;QACvE,uCAAuC;QACvC,OAAO,gBAAgB,CAAC,IAAI,CAAC,IAAI,yBAAyB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACzF,CAAC,CAAC,CAAC;IACH,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,IAAI,WAAW,CAAC;QAC5C,MAAM,GAAG,GAAG,UAAU,CAAC,UAAU,IAAI,SAAS,CAAC;QAC/C,OAAO;YACL,gBAAgB,EAAE,IAAI;YACtB,iBAAiB,EAAE,wBAAwB,IAAI,EAAE;YACjD,UAAU,EAAE,aAAa;YACzB,UAAU,EAAE,GAAG;YACf,IAAI,EAAE,UAAU,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;YACnE,gBAAgB,EAAE,SAAS;YAC3B,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,SAAS;SACvB,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;AAC7D,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,IAG7B;IACC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,IAAI,WAAW,CAAC;IACzC,MAAM,MAAM,GACV,GAAG,KAAK,WAAW;QACjB,CAAC,CAAC,qIAAqI;QACvI,CAAC,CAAC,4EAA4E,GAAG,+BAA+B,CAAC;IACrH,MAAM,CAAC,GAAG,MAAM,UAAU,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IAC9F,IAAI,CAAC,CAAC,SAAS,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO;YACL,gBAAgB,EAAE,KAAK;YACvB,WAAW,EAAE,SAAS;YACtB,eAAe,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;SACxC,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,eAAe,EAAE,CAAC;QACpD,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;IAC7D,CAAC;IACD,OAAO;QACL,gBAAgB,EAAE,IAAI;QACtB,iBAAiB,EAAE,gBAAgB,GAAG,EAAE;QACxC,gBAAgB,EAAE,SAAS;QAC3B,UAAU,EAAE,GAAG;QACf,WAAW,EAAE,SAAS;KACvB,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,IAG/B;IACC,wDAAwD;IACxD,MAAM,CAAC,GAAG,MAAM,UAAU,CACxB,SAAS,EACT,CAAC,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,GAAG,CAAC,EAC1C,IAAI,CAAC,GAAG,EACR,SAAS,EACT,SAAS,EACT,IAAI,CACL,CAAC;IACF,IAAI,CAAC,CAAC,SAAS,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO;YACL,gBAAgB,EAAE,KAAK;YACvB,WAAW,EAAE,SAAS;YACtB,eAAe,EAAE,mFAAmF;SACrG,CAAC;IACJ,CAAC;IACD,mEAAmE;IACnE,6DAA6D;IAC7D,qDAAqD;IACrD,kCAAkC;IAClC,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;AAC7D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;QAC3B,OAAO;QACP,cAAc;QACd,aAAa;QACb,OAAO;QACP,MAAM;QACN,iBAAiB;QACjB,cAAc;QACd,WAAW;QACX,QAAQ;QACR,WAAW;QACX,eAAe;QACf,QAAQ;QACR,MAAM;KACP,CAAC,CAAC;IACH,OAAO,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC"}

package/dist/tools/gate_check.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gate_check.d.ts","sourceRoot":"","sources":["../../src/tools/gate_check.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EAEf,cAAc,EAEf,MAAM,sBAAsB,CAAC;AAoC9B,wBAAsB,YAAY,CAChC,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,cAAc,EACtB,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAiG1B;AAyDD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"gate_check.d.ts","sourceRoot":"","sources":["../../src/tools/gate_check.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EAEf,cAAc,EAEf,MAAM,sBAAsB,CAAC;AAwC9B,wBAAsB,YAAY,CAChC,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,cAAc,EACtB,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAiG1B;AA2DD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/tools/gate_check.js

@@ -8,6 +8,7 @@ import { incrementGateAttempts, resetLoopState, snapshotLoopStateToRun, shouldEs
 import { collectInteractionCoverage, detectJourneyArcs, evaluateDepth, evaluateUserJourney, resolveDepthMinimums, } from "../evidence/interaction_coverage.js";
 import { evaluateChangeCoverage, resolveChangeCoverageConfig, } from "../evidence/change_coverage.js";
 import { formatStalenessSuffix, isEvidenceStale, isRunEvidenceStale, runEvidenceMtime, } from "../evidence/evidence_freshness.js";
+import { loadCycleIssues, summariseCycleIssue, } from "../evidence/cycle_issues.js";
 export async function runGateCheck(input, config, cwd = process.cwd()) {
     const baseDir = getArtifactsBaseDir(cwd);
     const meta = loadRunMeta(input.run_id, baseDir);
@@ -127,6 +128,8 @@ function nextStepForGate(name, reason, cwd) {
                 "[H11] If the journey stalled mid-arc, an UNHANDLED MODAL is the most likely cause: Save? / Confirm delete / validation toast / license dialog. AFTER each codeloop_interact call inspect the latest screenshot, then call codeloop_handle_modal with the appropriate decision (\"confirm\" / \"cancel\" / \"dismiss\") before the next interact. An unhandled modal blocks every subsequent click and silently drops the rest of the planned arc on the floor.");
         case "design_compare_evidence":
             return `Design comparison failed (${reason}). Either (a) the reference designs depict a populated state that differs from the running app — seed the app's database / state to match the references before re-capturing; or (b) the captured screenshots are named differently from the references — re-capture using the reference filename (e.g. codeloop_capture_screenshot screen_name='dashboard' matches designs/dashboard.png); or (c) update / remove the irrelevant reference designs under designs/ if they no longer reflect the intended UI.`;
+        case "cycle_issues_acknowledged":
+            return "Recurrence-class issues were recorded mid-cycle (modal_close_failed / binary_mismatch / click_missed_target / app_restart / high_failure_rate). Read artifacts/runs/<latest>/logs/cycle_issues.jsonl, then either (a) fix the root cause and call codeloop_verify again so the resolution is implicit, or (b) write one line per issue into logs/cycle_issue_resolutions.jsonl with { issue_kind, resolved_by, note } and explicitly enumerate each in your gate-response summary. Do NOT use 'all gates green' boilerplate — the C6 anti-rationalisation scan blocks that exact phrasing.";
         case "visual_regression_threshold":
             return "A visual diff exceeded the regression threshold. Open artifacts/runs/<run_id>/diffs/ to see which screen changed; fix the regression in the implementation OR update the baseline by copying the new screenshot into the baseline path.";
         default:
@@ -312,6 +315,22 @@ async function evaluateEvidenceGates(runId, cwd, config) {
     }
     catch { /* best-effort */ }
     const verdict = evaluateDepth(coverage, minimums, discoverySnapshot);
+    // 0.1.54 E6 — Failed-interaction-rate warning. evaluateDepth attaches
+    // a structured `failure_rate_warning` when failed/(failed+successful)
+    // exceeds 10%. We mirror that into cycle_issues.jsonl so the new
+    // cycle_issues_acknowledged blocker surfaces it to the agent's gate
+    // response instead of letting a "depth=passed" verdict mask the
+    // bad-coordinate loop the agent kept losing time on.
+    if (verdict.failure_rate_warning) {
+        const { recordCycleIssue } = await import("../evidence/cycle_issues.js");
+        await recordCycleIssue(cwd, {
+            kind: "high_failure_rate",
+            failed: verdict.failure_rate_warning.failed,
+            successful: verdict.failure_rate_warning.successful,
+            total: verdict.failure_rate_warning.total,
+            ratio: verdict.failure_rate_warning.ratio,
+        });
+    }
     // 0.1.53 D2 — Evidence freshness for interaction logs. The base
     // verdict aggregates EVERY interaction_log.jsonl across EVERY run in
     // the project's artifacts directory, so once an agent has historically
@@ -550,6 +569,44 @@ async function evaluateEvidenceGates(runId, cwd, config) {
             ? changeVerdict.reason
             : `${changeVerdict.reason}\n${changeVerdict.next_step}`,
     });
+    // 0.1.54 E2 — cycle_issues_acknowledged blocker.
+    //
+    // Photometry-DB E2E #11 shipped at 100% confidence with `ready_for_review`
+    // even though three real recurrence-class issues happened mid-cycle (stuck
+    // OpenFolderDialog, binary-vs-source mismatch, hard app restart). They
+    // were buried in the dev log and never surfaced to the user. This gate
+    // blocks the whole cycle until the agent enumerates each unresolved entry
+    // from cycle_issues.jsonl in its gate response — see the directive
+    // generated below.
+    const cycleIssuesGate = {
+        name: "cycle_issues_acknowledged",
+        description: "Recurrence-class issues recorded during the cycle must be acknowledged before reporting ready_for_review.",
+        rule: "Every entry in cycle_issues.jsonl has a sibling resolution OR the agent's gate response enumerates each one",
+        input_artifacts: ["logs/cycle_issues.jsonl", "logs/cycle_issue_resolutions.jsonl"],
+        pass_threshold: true,
+        severity_if_failed: "blocker",
+        retry_allowance: 5,
+        escalation_condition: "Cycle issues remain unresolved after 5 attempts",
+    };
+    const cycleIssues = await loadCycleIssues(cwd);
+    if (cycleIssues.unresolved.length === 0) {
+        results.push({
+            gate: cycleIssuesGate,
+            passed: true,
+            reason: cycleIssues.issues.length === 0
+                ? "No recurrence-class issues recorded this cycle"
+                : `All ${cycleIssues.issues.length} recorded cycle issue(s) have a sibling resolution`,
+        });
+    }
+    else {
+        const summary = cycleIssues.unresolved.map((issue) => `  • ${summariseCycleIssue(issue)}`).join("\n");
+        results.push({
+            gate: cycleIssuesGate,
+            passed: false,
+            reason: `${cycleIssues.unresolved.length} unresolved cycle issue(s) — your gate-response summary MUST enumerate each one and how it was resolved (or escalated). Do NOT report ready_for_review without acknowledging:\n${summary}\n` +
+                `Resolutions: either fix the underlying problem and call codeloop_verify again, OR call codeloop_escalate with the issue's kind to surface it to the user. Generic "all gates green" / "everything looks good" summaries will fail the C6 anti-rationalisation scan.`,
+        });
+    }
     return results;
 }
 function evaluateGate(gate, meta, config, specContent, acceptanceContent, cwd) {