codeloop-mcp-server 0.1.73 → 0.1.75

package/dist/runners/flutter.d.ts

@@ -2,4 +2,21 @@ import type { RunnerResult } from "./base.js";
 export declare function runFlutterAnalyze(cwd: string, logPath: string): Promise<RunnerResult>;
 export declare function runFlutterTest(cwd: string, logPath: string): Promise<RunnerResult>;
 export declare function runFlutterIntegrationTest(cwd: string, logPath: string): Promise<RunnerResult>;
+/**
+ * Severity-aware classification of `flutter analyze` output.
+ *
+ * `flutter analyze` lists every diagnostic — info, warning AND error — and
+ * prints a trailing "N issues found." total. The OLD parser matched that total
+ * and reported it ALL as `failed`, so a project with thousands of harmless
+ * `avoid_print`/style INFO lints (and maybe one real error) looked
+ * catastrophically broken. We now classify by severity and let the caller fail
+ * only on ERRORS (matching the deep-internal static_analysis gate's
+ * errors-only policy), while still surfacing the warning/info counts.
+ */
+export declare function classifyAnalyzeOutput(output: string): {
+    errors: number;
+    warnings: number;
+    infos: number;
+    total: number;
+};
 //# sourceMappingURL=flutter.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"flutter.d.ts","sourceRoot":"","sources":["../../src/runners/flutter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AA2C9C,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,YAAY,CAAC,CA2CvB;AAED,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,YAAY,CAAC,CAuDvB;AAED,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,YAAY,CAAC,CAsGvB"}
+{"version":3,"file":"flutter.d.ts","sourceRoot":"","sources":["../../src/runners/flutter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AA4C9C,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,YAAY,CAAC,CAiEvB;AAED,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,YAAY,CAAC,CAuDvB;AAED,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,YAAY,CAAC,CAsGvB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,CAWA"}

package/dist/runners/flutter.js

@@ -1,5 +1,6 @@
 import { runCommand, checkToolAvailable, makeSkippedResult } from "./base.js";
 import { runFlutterAnalyzeOnce, runFlutterTestCoverageOnce, FLUTTER_TEST_SETTLE, FLUTTER_TEST_STALL, } from "./flutter_cache.js";
+import { parseFlutterAnalyzeOutput, reconcile } from "./static_analysis.js";
 import { existsSync } from "fs";
 import { join } from "path";
 // Wall-clock watchdogs for the Flutter verify commands. Before this, all
@@ -55,18 +56,39 @@ export async function runFlutterAnalyze(cwd, logPath) {
             stderr: `${note}\n${result.stderr}`,
         };
     }
-    const analyzeResult = parseAnalyzeOutput(result.stdout + result.stderr);
+    const combined = result.stdout + result.stderr;
+    const { errors, warnings, infos, total } = classifyAnalyzeOutput(combined);
+    // ERRORS-ONLY blocker policy (same as the deep-internal static_analysis
+    // gate): only error-severity diagnostics count as failures. `reconcile`
+    // promotes an UNEXPLAINED non-zero exit (0 errors AND 0 warnings parsed) to
+    // a single error so a parser miss / tool crash never silently passes; it
+    // does NOT promote when warnings explain the non-zero exit.
+    const failed = reconcile({ errors, warnings }, result.exit_code).errors;
+    // Surface the warning/info breakdown so the agent SEES the lint debt without
+    // it inflating the failure count. Before this fix the runner reported EVERY
+    // issue (info + warning + error) as a failure — a Flutter app with 2,517
+    // mostly-`avoid_print` info lints in tool/ scripts and ONE real error
+    // produced `failed: 2517` (the WedCheese "2524 failed" headline), which
+    // tanked confidence to 0 and made the build gate fail on lint noise.
+    let stderr = result.stderr;
+    if (total > 0 && (warnings > 0 || infos > 0)) {
+        stderr =
+            `[CodeLoop] flutter analyze: ${failed} error(s) [BLOCKING], ` +
+                `${warnings} warning(s), ${infos} info(s) [NON-BLOCKING lint, e.g. avoid_print]. ` +
+                `Only errors fail the build gate; the ${warnings + infos} warning/info ` +
+                `finding(s) are surfaced for cleanup but do NOT count as failures.\n${stderr}`;
+    }
     return {
         runner_name: "flutter_analyze",
         available: true,
         exit_code: result.exit_code,
-        passed: analyzeResult.passed,
-        failed: analyzeResult.failed,
+        passed: failed === 0 ? 1 : 0,
+        failed,
         skipped: 0,
         log_path: logPath,
         duration_ms: result.duration_ms,
         stdout: result.stdout,
-        stderr: result.stderr,
+        stderr,
     };
 }
 export async function runFlutterTest(cwd, logPath) {
@@ -196,16 +218,28 @@ export async function runFlutterIntegrationTest(cwd, logPath) {
         stderr: result.stderr,
     };
 }
-function parseAnalyzeOutput(output) {
-    // "No issues found!" or "X issue(s) found"
-    if (output.includes("No issues found")) {
-        return { passed: 1, failed: 0 };
-    }
-    const issueMatch = output.match(/(\d+)\s+issue/);
-    if (issueMatch) {
-        return { passed: 0, failed: parseInt(issueMatch[1], 10) };
+/**
+ * Severity-aware classification of `flutter analyze` output.
+ *
+ * `flutter analyze` lists every diagnostic — info, warning AND error — and
+ * prints a trailing "N issues found." total. The OLD parser matched that total
+ * and reported it ALL as `failed`, so a project with thousands of harmless
+ * `avoid_print`/style INFO lints (and maybe one real error) looked
+ * catastrophically broken. We now classify by severity and let the caller fail
+ * only on ERRORS (matching the deep-internal static_analysis gate's
+ * errors-only policy), while still surfacing the warning/info counts.
+ */
+export function classifyAnalyzeOutput(output) {
+    if (/No issues found/i.test(output)) {
+        return { errors: 0, warnings: 0, infos: 0, total: 0 };
     }
-    return { passed: 0, failed: 0 };
+    // parseFlutterAnalyzeOutput counts `error •` / `warning •` severity lines.
+    const { errors, warnings } = parseFlutterAnalyzeOutput(output);
+    const totalMatch = output.match(/(\d+)\s+issue/);
+    const total = totalMatch ? parseInt(totalMatch[1], 10) : errors + warnings;
+    // Anything in the total that isn't an error or warning is an info lint.
+    const infos = Math.max(0, total - errors - warnings);
+    return { errors, warnings, infos, total };
 }
 function parseFlutterTestOutput(output) {
     let passed = 0;

package/dist/runners/flutter.js.map

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

package/dist/runners/interaction_engine.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Interaction engine — the reusable core that DRIVES a single UI step against
+ * a running app, across all four target types (browser / desktop / Android /
+ * iOS). It dispatches the journey-relevant action set to the same low-level
+ * primitives the `codeloop_interact` MCP tool uses (browser_interaction.ts +
+ * window_manager.ts), so the new server-side orchestrator (codeloop_run_journey)
+ * can drive a planned journey end-to-end WITHOUT a per-step MCP round-trip.
+ *
+ * Scope: this engine intentionally covers the subset of actions a planned
+ * journey needs (navigate, click, type, submit, fill, read-back/assert, scroll,
+ * wait, simple mobile taps/keys). The full, exhaustive action surface (UIA
+ * automation, Maestro flows, biometric, network shaping, drag, etc.) remains in
+ * the `codeloop_interact` tool. When the engine hits an action or a missing
+ * field it can't satisfy, it returns `{ success: false, unsupported: true }`
+ * with a directive so the orchestrator can fall back to the agent instead of
+ * failing the whole run.
+ */
+export type JourneyTarget = "browser" | "desktop" | "android_emulator" | "ios_simulator";
+export interface InteractionStep {
+    action: string;
+    selector?: string;
+    text?: string;
+    url?: string;
+    x?: number;
+    y?: number;
+    x2?: number;
+    y2?: number;
+    key?: string;
+    keys?: string;
+    direction?: "up" | "down" | "left" | "right";
+    amount?: number;
+    duration_ms?: number;
+    /** [get_text] assert the read-back text contains this substring (ci). */
+    expect_contains?: string;
+    /** Semantic label for CRUD/intent classification (logged by the caller). */
+    intent?: string;
+}
+export interface InteractionContext {
+    target: JourneyTarget;
+    /** App name for desktop front-bring (optional). */
+    app_name?: string;
+}
+export interface InteractionResult {
+    action: string;
+    success: boolean;
+    detail: string;
+    /** Text read back by a get_text action. */
+    extractedText?: string | null;
+    assertion?: {
+        expected: string;
+        matched: boolean;
+        actual_excerpt: string;
+    };
+    /** True when the engine can't satisfy this step (caller should fall back). */
+    unsupported?: boolean;
+}
+/** Drive a single journey step. Never throws; returns a structured result. */
+export declare function executeInteraction(step: InteractionStep, ctx: InteractionContext): Promise<InteractionResult>;
+//# sourceMappingURL=interaction_engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interaction_engine.d.ts","sourceRoot":"","sources":["../../src/runners/interaction_engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,SAAS,GACT,kBAAkB,GAClB,eAAe,CAAC;AAEpB,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,aAAa,CAAC;IACtB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3E,8EAA8E;IAC9E,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AA0BD,8EAA8E;AAC9E,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,eAAe,EACrB,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC,iBAAiB,CAAC,CAwB5B"}

package/dist/runners/interaction_engine.js

@@ -0,0 +1,272 @@
+/**
+ * Interaction engine — the reusable core that DRIVES a single UI step against
+ * a running app, across all four target types (browser / desktop / Android /
+ * iOS). It dispatches the journey-relevant action set to the same low-level
+ * primitives the `codeloop_interact` MCP tool uses (browser_interaction.ts +
+ * window_manager.ts), so the new server-side orchestrator (codeloop_run_journey)
+ * can drive a planned journey end-to-end WITHOUT a per-step MCP round-trip.
+ *
+ * Scope: this engine intentionally covers the subset of actions a planned
+ * journey needs (navigate, click, type, submit, fill, read-back/assert, scroll,
+ * wait, simple mobile taps/keys). The full, exhaustive action surface (UIA
+ * automation, Maestro flows, biometric, network shaping, drag, etc.) remains in
+ * the `codeloop_interact` tool. When the engine hits an action or a missing
+ * field it can't satisfy, it returns `{ success: false, unsupported: true }`
+ * with a directive so the orchestrator can fall back to the agent instead of
+ * failing the whole run.
+ */
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+function unsupported(action, why) {
+    return {
+        action,
+        success: false,
+        unsupported: true,
+        detail: `[engine] ${why} — fall back to codeloop_interact for this step.`,
+    };
+}
+function buildAssertion(expect, actual) {
+    if (!expect)
+        return undefined;
+    const hay = (actual ?? "").toLowerCase();
+    return {
+        expected: expect,
+        matched: hay.includes(expect.toLowerCase()),
+        actual_excerpt: (actual ?? "").slice(0, 280),
+    };
+}
+/** Drive a single journey step. Never throws; returns a structured result. */
+export async function executeInteraction(step, ctx) {
+    const action = step.action;
+    try {
+        // wait is target-agnostic.
+        if (action === "wait") {
+            await sleep(step.duration_ms ?? 1000);
+            return { action, success: true, detail: `waited ${step.duration_ms ?? 1000}ms` };
+        }
+        switch (ctx.target) {
+            case "browser":
+                return await driveBrowser(step, ctx);
+            case "desktop":
+                return await driveDesktop(step, ctx);
+            case "android_emulator":
+                return await driveAndroid(step, ctx);
+            case "ios_simulator":
+                return await driveIos(step, ctx);
+            default:
+                return unsupported(action, `unknown target ${String(ctx.target)}`);
+        }
+    }
+    catch (e) {
+        return { action, success: false, detail: `[engine] error: ${e.message}` };
+    }
+}
+// ── Browser (Playwright) ────────────────────────────────────────────
+async function driveBrowser(step, _ctx) {
+    const bi = await import("./browser_interaction.js");
+    await bi.ensureBrowserPage();
+    const a = step.action;
+    const sel = step.selector;
+    switch (a) {
+        case "navigate_url":
+            if (!step.url)
+                return unsupported(a, "navigate_url needs a url");
+            return { action: a, success: await bi.browserNavigate(step.url), detail: `navigate ${step.url}` };
+        case "navigate_back":
+            return { action: a, success: await bi.browserGoBack(), detail: "back" };
+        case "navigate_forward":
+            return { action: a, success: await bi.browserGoForward(), detail: "forward" };
+        case "click":
+            if (!sel)
+                return unsupported(a, "browser click needs a selector");
+            return { action: a, success: await bi.browserClick(sel), detail: `click ${sel}` };
+        case "double_click":
+            if (!sel)
+                return unsupported(a, "double_click needs a selector");
+            return { action: a, success: await bi.browserDoubleClick(sel), detail: `double_click ${sel}` };
+        case "hover":
+            if (!sel)
+                return unsupported(a, "hover needs a selector");
+            return { action: a, success: await bi.browserHover(sel), detail: `hover ${sel}` };
+        case "type":
+            if (!sel || step.text == null)
+                return unsupported(a, "type needs selector+text");
+            return { action: a, success: await bi.browserType(sel, step.text), detail: `type into ${sel}` };
+        case "type_and_submit":
+            if (!sel || step.text == null)
+                return unsupported(a, "type_and_submit needs selector+text");
+            return { action: a, success: await bi.browserTypeAndSubmit(sel, step.text), detail: `type+submit ${sel}` };
+        case "type_and_tab":
+            if (!sel || step.text == null)
+                return unsupported(a, "type_and_tab needs selector+text");
+            return { action: a, success: await bi.browserTypeAndTab(sel, step.text), detail: `type+tab ${sel}` };
+        case "select_option":
+            if (!sel || step.text == null)
+                return unsupported(a, "select_option needs selector+value");
+            return { action: a, success: await bi.browserSelectOption(sel, step.text), detail: `select ${sel}` };
+        case "toggle":
+            if (!sel)
+                return unsupported(a, "toggle needs a selector");
+            return { action: a, success: await bi.browserToggle(sel), detail: `toggle ${sel}` };
+        case "scroll":
+            return { action: a, success: await bi.browserScroll(step.direction ?? "down", step.amount ?? 300), detail: `scroll ${step.direction ?? "down"}` };
+        case "hotkey":
+            if (!step.keys)
+                return unsupported(a, "hotkey needs keys");
+            return { action: a, success: await bi.browserHotkey(step.keys), detail: `hotkey ${step.keys}` };
+        case "keystroke":
+            if (!step.key)
+                return unsupported(a, "keystroke needs key");
+            return { action: a, success: await bi.browserKeystroke(step.key), detail: `key ${step.key}` };
+        case "get_text": {
+            const text = await bi.browserGetText(sel);
+            const assertion = buildAssertion(step.expect_contains, text);
+            return {
+                action: a,
+                success: assertion ? assertion.matched : text != null,
+                detail: assertion ? `assert "${step.expect_contains}" -> ${assertion.matched}` : "read text",
+                extractedText: text,
+                assertion,
+            };
+        }
+        default:
+            return unsupported(a, `browser action "${a}" not in the engine subset`);
+    }
+}
+// ── Desktop (CGEvent / user32 / xdotool) ────────────────────────────
+async function driveDesktop(step, ctx) {
+    const wm = await import("./window_manager.js");
+    if (ctx.app_name) {
+        try {
+            await wm.bringAppToFront(ctx.app_name);
+        }
+        catch { /* best-effort */ }
+    }
+    const a = step.action;
+    switch (a) {
+        case "navigate_url":
+            if (!step.url)
+                return unsupported(a, "navigate_url needs a url");
+            return { action: a, success: await wm.navigateDesktopBrowser(step.url), detail: `open ${step.url}` };
+        case "click":
+            if (step.x == null || step.y == null)
+                return unsupported(a, "desktop click needs x,y (or use codeloop_interact for text/UIA targeting)");
+            return { action: a, success: await wm.clickAtPosition(step.x, step.y), detail: `click (${step.x},${step.y})` };
+        case "double_click":
+            if (step.x == null || step.y == null)
+                return unsupported(a, "double_click needs x,y");
+            return { action: a, success: await wm.doubleClickAtPosition(step.x, step.y), detail: `double_click (${step.x},${step.y})` };
+        case "right_click":
+            if (step.x == null || step.y == null)
+                return unsupported(a, "right_click needs x,y");
+            return { action: a, success: await wm.rightClickAtPosition(step.x, step.y), detail: `right_click (${step.x},${step.y})` };
+        case "hover":
+            if (step.x == null || step.y == null)
+                return unsupported(a, "hover needs x,y");
+            return { action: a, success: await wm.hoverAtPosition(step.x, step.y), detail: `hover (${step.x},${step.y})` };
+        case "type":
+            if (step.text == null)
+                return unsupported(a, "type needs text");
+            return { action: a, success: await wm.typeText(step.text), detail: "type" };
+        case "scroll":
+            if (step.x == null || step.y == null)
+                return unsupported(a, "desktop scroll needs x,y");
+            return { action: a, success: await wm.scrollAtPosition(step.x, step.y, step.direction ?? "down", step.amount ?? 3), detail: `scroll ${step.direction ?? "down"}` };
+        case "hotkey":
+            if (!step.keys)
+                return unsupported(a, "hotkey needs keys");
+            return { action: a, success: await wm.sendHotkey(step.keys), detail: `hotkey ${step.keys}` };
+        case "keystroke":
+            if (!step.key)
+                return unsupported(a, "keystroke needs key");
+            return { action: a, success: await wm.sendKeyByName(step.key), detail: `key ${step.key}` };
+        default:
+            return unsupported(a, `desktop action "${a}" not in the engine subset`);
+    }
+}
+// ── Android (adb) ───────────────────────────────────────────────────
+async function driveAndroid(step, _ctx) {
+    const wm = await import("./window_manager.js");
+    const a = step.action;
+    switch (a) {
+        case "click":
+        case "tap":
+            if (step.x == null || step.y == null)
+                return unsupported(a, "android tap needs x,y");
+            return { action: a, success: await wm.adbTap(step.x, step.y), detail: `tap (${step.x},${step.y})` };
+        case "type":
+            if (step.text == null)
+                return unsupported(a, "type needs text");
+            return { action: a, success: await wm.adbType(step.text), detail: "type" };
+        case "type_and_submit":
+            if (step.text == null)
+                return unsupported(a, "type_and_submit needs text");
+            {
+                const typed = await wm.adbType(step.text);
+                const entered = await wm.adbKey("66"); /* KEYCODE_ENTER */
+                return { action: a, success: typed && entered, detail: "type+enter" };
+            }
+        case "keystroke":
+            if (!step.key)
+                return unsupported(a, "keystroke needs key");
+            return { action: a, success: await wm.adbKey(step.key), detail: `key ${step.key}` };
+        case "back_button":
+        case "navigate_back":
+            return { action: a, success: await wm.adbBackButton(), detail: "back" };
+        case "swipe":
+        case "scroll": {
+            // Default vertical swipe gesture for scrolling.
+            const x1 = step.x ?? 540, y1 = step.y ?? 1200, x2 = step.x2 ?? 540, y2 = step.y2 ?? 400;
+            return { action: a, success: await wm.adbSwipe(x1, y1, x2, y2, step.duration_ms ?? 300), detail: "swipe" };
+        }
+        case "navigate_url":
+        case "deep_link":
+            if (!step.url)
+                return unsupported(a, "deep_link needs a url");
+            return { action: a, success: await wm.adbDeepLink(step.url), detail: `deep link ${step.url}` };
+        case "get_text": {
+            const text = await wm.adbGetText(step.selector);
+            const assertion = buildAssertion(step.expect_contains, text);
+            return {
+                action: a,
+                success: assertion ? assertion.matched : text != null,
+                detail: assertion ? `assert "${step.expect_contains}" -> ${assertion.matched}` : "read text",
+                extractedText: text,
+                assertion,
+            };
+        }
+        default:
+            return unsupported(a, `android action "${a}" not in the engine subset`);
+    }
+}
+// ── iOS (simctl) ────────────────────────────────────────────────────
+async function driveIos(step, _ctx) {
+    const wm = await import("./window_manager.js");
+    const a = step.action;
+    switch (a) {
+        case "click":
+        case "tap":
+            if (step.x == null || step.y == null)
+                return unsupported(a, "ios tap needs x,y");
+            return { action: a, success: await wm.simctlTap(step.x, step.y), detail: `tap (${step.x},${step.y})` };
+        case "type":
+            if (step.text == null)
+                return unsupported(a, "type needs text");
+            return { action: a, success: await wm.simctlType(step.text), detail: "type" };
+        case "navigate_url":
+        case "deep_link":
+            if (!step.url)
+                return unsupported(a, "deep_link needs a url");
+            return { action: a, success: await wm.simctlOpenUrl(step.url), detail: `open ${step.url}` };
+        case "swipe":
+        case "scroll": {
+            const x1 = step.x ?? 200, y1 = step.y ?? 600, x2 = step.x2 ?? 200, y2 = step.y2 ?? 200;
+            return { action: a, success: await wm.simctlSwipe(x1, y1, x2, y2, step.duration_ms ?? 300), detail: "swipe" };
+        }
+        case "get_text":
+            // iOS text read-back isn't available via simctl; vision (screenshot) only.
+            return unsupported(a, "iOS get_text needs vision — use codeloop_capture_screenshot");
+        default:
+            return unsupported(a, `ios action "${a}" not in the engine subset`);
+    }
+}
+//# sourceMappingURL=interaction_engine.js.map

package/dist/runners/interaction_engine.js.map

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

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;AA4D9B,wBAAsB,YAAY,CAChC,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,cAAc,EACtB,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAwG1B;AAyED,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;AA6D9B,wBAAsB,YAAY,CAChC,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,cAAc,EACtB,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAwG1B;AA2ED,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/tools/gate_check.js

@@ -10,7 +10,7 @@ import { evaluateChangeCoverage, resolveChangeCoverageConfig, } from "../evidenc
 import { formatStalenessSuffix, isEvidenceStale, isRunEvidenceStale, runEvidenceMtime, } from "../evidence/evidence_freshness.js";
 import { loadCycleIssues, summariseCycleIssue, } from "../evidence/cycle_issues.js";
 import { loadCodeQualityEvidence, evaluateStaticAnalysisGate, evaluateCoverageGate, resolveCoverageThreshold, } from "../evidence/deep_internal.js";
-import { loadBackendVerification, evaluateBackendSmokeGate, evaluateApiContractGate, evaluateDbSchemaGate, } from "../evidence/backend_verification.js";
+import { loadBackendVerification, evaluateBackendSmokeGate, evaluateApiContractGate, evaluateDbSchemaGate, evaluateBackendTestsGate, } from "../evidence/backend_verification.js";
 import { loadRuntimeLogScan, evaluateRuntimeLogGate, } from "../evidence/runtime_log_scan.js";
 import { loadObservabilityEvidence, evaluateObservabilityGate, } from "../evidence/observability.js";
 export async function runGateCheck(input, config, cwd = process.cwd()) {
@@ -154,6 +154,8 @@ function nextStepForGate(name, reason, cwd) {
             return `API responses violate the declared contract (${reason}). Reconcile the route handlers with the OpenAPI/Swagger schema (or update the schema if the change is intentional), then call codeloop_verify.`;
         case "db_schema_evidence":
             return `Database schema drift or a failed migration (${reason}). Generate + apply the pending migration for your ORM (dotnet ef migrations add / Django makemigrations / alembic revision --autogenerate / prisma migrate dev / rails db:migrate), then call codeloop_verify.`;
+        case "backend_tests_evidence":
+            return `The backend's own test suite is failing (${reason}). Run it directly in the backend dir (npm test / pytest / dotnet test / go test) to see the failures, fix the backend logic or tests, then call codeloop_verify.`;
         case "logging_observability_evidence":
             return `The project lacks a logging system (${reason}). Read artifacts/runs/<latest>/observability.json for the per-stack recommendations, then BUILD the missing piece(s): (1) a structured, leveled logger (pino/winston, Python logging/loguru, Serilog/ILogger, slog/zap, tracing) wired through the app instead of bare console/print; (2) request/HTTP logging middleware on servers (method, path, status, latency); (3) a global error handler / React error boundary that logs the full stack trace at the boundary. Persist logs to ./logs when observability.require_log_sink is on. Then call codeloop_verify. Per-project tuning lives in .codeloop/config.json -> observability.`;
         default:
@@ -712,6 +714,18 @@ function evaluateDeepInternalGates(runId, cwd, config) {
     };
     const dbVerdict = evaluateDbSchemaGate(backend);
     results.push({ gate: dbSchemaGate, passed: dbVerdict.passed, reason: dbVerdict.reason });
+    const backendTestsGate = {
+        name: "backend_tests_evidence",
+        description: "The backend's OWN dedicated test suite (functions/server/api subdir) must pass in detail.",
+        rule: "backend_verification.json backend_tests.passed === true (n/a when no backend test suite)",
+        input_artifacts: ["backend_verification.json"],
+        pass_threshold: true,
+        severity_if_failed: "blocker",
+        retry_allowance: 5,
+        escalation_condition: "Backend test suite still failing after 5 attempts",
+    };
+    const backendTestsVerdict = evaluateBackendTestsGate(backend);
+    results.push({ gate: backendTestsGate, passed: backendTestsVerdict.passed, reason: backendTestsVerdict.reason });
     // ── runtime_log_clean_evidence (Phase 2) ─────────────────────────
     const logScan = loadRuntimeLogScan(runDir);
     const runtimeLogGate = {