codeloop-mcp-server 0.1.18 → 0.1.20

package/dist/evidence/artifacts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../src/evidence/artifacts.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAIxD,wBAAgB,aAAa,IAAI,MAAM,CAItC;AAED,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAEvE;AAED,wBAAgB,YAAY,CAC1B,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,GACf;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAWnC;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,GACzB,IAAI,CAGN;AAED,wBAAgB,WAAW,CACzB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAmB7B;AAED,wBAAgB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAWnD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAGjE"}
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../src/evidence/artifacts.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAIxD,wBAAgB,aAAa,IAAI,MAAM,CAItC;AAED,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAEvE;AAED,wBAAgB,YAAY,CAC1B,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,GACf;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAWnC;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,GACzB,IAAI,CAGN;AAED,wBAAgB,WAAW,CACzB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAmB7B;AAYD,wBAAgB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAkBnD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAGjE"}

package/dist/evidence/artifacts.js

@@ -42,16 +42,34 @@ export function loadRunMeta(runIdOrDir, baseDir) {
         return null;
     }
 }
+/**
+ * Real run IDs generated by `generateRunId()` have the shape
+ * `run_<ms-timestamp>_<6-char-rand>`. Phantom directories (`run_visual_v2`,
+ * `run_test`, ad-hoc seed folders, etc.) silently broke design_compare and
+ * check_workflow because the old lexicographic sort placed `run_v…` before
+ * every numeric run (digits < letters in ASCII). We now require the strict
+ * shape and sort by parsed timestamp numerically, descending.
+ */
+const RUN_ID_PATTERN = /^run_(\d+)_[a-z0-9]+$/i;
 export function listRuns(baseDir) {
     const base = baseDir || getArtifactsBaseDir();
     if (!existsSync(base)) {
         return [];
     }
-    return readdirSync(base, { withFileTypes: true })
-        .filter((d) => d.isDirectory() && d.name.startsWith("run_"))
-        .map((d) => d.name)
-        .sort()
-        .reverse();
+    const validRuns = [];
+    for (const entry of readdirSync(base, { withFileTypes: true })) {
+        if (!entry.isDirectory())
+            continue;
+        const match = entry.name.match(RUN_ID_PATTERN);
+        if (!match)
+            continue;
+        const ts = parseInt(match[1], 10);
+        if (Number.isNaN(ts))
+            continue;
+        validRuns.push({ name: entry.name, ts });
+    }
+    validRuns.sort((a, b) => b.ts - a.ts);
+    return validRuns.map((r) => r.name);
 }
 export function getRunDir(runId, baseDir) {
     const base = baseDir || getArtifactsBaseDir();

package/dist/evidence/artifacts.js.map

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

package/dist/evidence/interaction_coverage.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Action-type buckets used to measure how DEEPLY an interaction recording
+ * exercised an app.
+ *
+ * The earlier `interaction_replay_evidence` gate is binary — it passes if
+ * an interaction log exists at all. That's too weak. The Photometry DB
+ * E2E session ran 47 entries but 28/29 successful interactions were pure
+ * navigation; only 1 was `type` and 0 were form submissions / toggles /
+ * uploads / gestures. The replay gate still passed.
+ *
+ * These buckets let a downstream gate distinguish "I clicked a sidebar
+ * link 8 times" from "I exercised every form field, submitted, toggled
+ * modes, and dragged a slider". Buckets are intentionally coarse — fine
+ * enough to spot a navigation-only run, broad enough that the agent
+ * doesn't have to game the categories.
+ */
+export interface InteractionBuckets {
+    navigation: number;
+    input: number;
+    commit: number;
+    toggle: number;
+    gesture: number;
+    upload: number;
+    click: number;
+    keystroke: number;
+    inspect: number;
+    wait: number;
+    other: number;
+}
+export interface InteractionCoverage {
+    total: number;
+    successful: number;
+    buckets: InteractionBuckets;
+    unique_screens: number;
+    /** Aggregate "depth points" — successful actions in buckets that exercise app state. */
+    depth_actions: number;
+}
+export interface DepthMinimums {
+    enabled: boolean;
+    total_successful: number;
+    input: number;
+    commit: number;
+    click: number;
+    navigation: number;
+    toggle: number;
+    gesture: number;
+    upload: number;
+}
+export declare const DEFAULT_DEPTH_MINIMUMS: DepthMinimums;
+/**
+ * Aggregate every interaction across every run in the project's artifacts
+ * directory. Runs without logs are skipped silently.
+ */
+export declare function collectInteractionCoverage(cwd: string): InteractionCoverage;
+export interface DepthVerdict {
+    passed: boolean;
+    reason: string;
+    shortfalls: Array<{
+        bucket: keyof InteractionBuckets | "total_successful";
+        required: number;
+        have: number;
+    }>;
+}
+/**
+ * Compare the observed coverage against the project's minimums. Returns
+ * the verdict plus a human-readable reason that lists EVERY shortfall —
+ * the agent uses this to know which buckets to fill in before re-gating.
+ */
+export declare function evaluateDepth(coverage: InteractionCoverage, minimums: DepthMinimums): DepthVerdict;
+/**
+ * Merge user-supplied minimums onto DEFAULT_DEPTH_MINIMUMS. Unknown / non-numeric
+ * fields fall back to the default.
+ */
+export declare function resolveDepthMinimums(override: Partial<DepthMinimums> | undefined): DepthMinimums;
+//# sourceMappingURL=interaction_coverage.d.ts.map

package/dist/evidence/interaction_coverage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction_coverage.d.ts","sourceRoot":"","sources":["../../src/evidence/interaction_coverage.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,wFAAwF;IACxF,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,sBAAsB,EAAE,aAUpC,CAAC;AA+MF;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CA0C3E;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,kBAAkB,GAAG,kBAAkB,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9G;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,mBAAmB,EAC7B,QAAQ,EAAE,aAAa,GACtB,YAAY,CA4Cd;AA4CD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,SAAS,GAC3C,aAAa,CAqBf"}

package/dist/evidence/interaction_coverage.js

@@ -0,0 +1,347 @@
+import { existsSync, readdirSync, readFileSync } from "fs";
+import { join } from "path";
+import { getArtifactsBaseDir, getRunDir, listRuns } from "./artifacts.js";
+export const DEFAULT_DEPTH_MINIMUMS = {
+    enabled: true,
+    total_successful: 20,
+    input: 3,
+    commit: 1,
+    click: 10,
+    navigation: 5,
+    toggle: 0,
+    gesture: 0,
+    upload: 0,
+};
+function emptyBuckets() {
+    return {
+        navigation: 0,
+        input: 0,
+        commit: 0,
+        toggle: 0,
+        gesture: 0,
+        upload: 0,
+        click: 0,
+        keystroke: 0,
+        inspect: 0,
+        wait: 0,
+        other: 0,
+    };
+}
+const COMMIT_HINT_WORDS = [
+    "submit",
+    "save",
+    "update",
+    "send",
+    "create",
+    "apply",
+    "confirm",
+    "login",
+    "log in",
+    "log-in",
+    "sign in",
+    "sign-in",
+    "sign up",
+    "sign-up",
+    "signup",
+    "register",
+    "ok",
+    "enter",
+    "search",
+    "go",
+];
+function isCommitClick(args) {
+    const hints = [args.selector, args.text, args.aria_label, args.label, args.target, args.automationId]
+        .filter((v) => typeof v === "string")
+        .map((v) => v.toLowerCase());
+    if (hints.length === 0)
+        return false;
+    return hints.some((h) => COMMIT_HINT_WORDS.some((w) => h.includes(w)));
+}
+function isCommitKey(args) {
+    const key = args.key?.toLowerCase() ?? "";
+    const combo = args.combo?.toLowerCase() ?? "";
+    return /(?:^|[+ ])(enter|return)$/.test(key) || /(?:^|[+ ])(enter|return)$/.test(combo);
+}
+function bucketOne(entry, buckets) {
+    const action = (entry.action ?? "").toLowerCase();
+    const args = entry.input_args ?? {};
+    const success = entry.success !== false; // default to true when absent
+    // `sequence` is a batch wrapper; walk its children and don't double-count.
+    if (action === "sequence" && Array.isArray(entry.steps)) {
+        for (const child of entry.steps)
+            bucketOne(child, buckets);
+        return;
+    }
+    if (!success) {
+        // Failed interactions don't count toward coverage but we still bucket
+        // them so the agent can see what it tried. Keep simple: skip entirely.
+        return;
+    }
+    switch (action) {
+        case "navigate_url":
+        case "navigate_back":
+        case "navigate_forward":
+        case "deep_link":
+        case "back_button":
+        case "home_button":
+            buckets.navigation += 1;
+            return;
+        case "type":
+        case "fill":
+            buckets.input += 1;
+            return;
+        case "type_and_submit":
+        case "type_and_tab":
+            buckets.input += 1;
+            buckets.commit += 1;
+            return;
+        case "fill_form": {
+            const fields = args.fields ?? [];
+            buckets.input += Math.max(1, fields.length);
+            if (args.submit_selector || args.submit)
+                buckets.commit += 1;
+            return;
+        }
+        case "toggle":
+        case "select_option":
+        case "select":
+            buckets.toggle += 1;
+            return;
+        case "scroll":
+        case "drag_drop":
+        case "swipe":
+        case "long_press":
+        case "hover":
+        case "pinch":
+        case "rotate_device":
+            buckets.gesture += 1;
+            return;
+        case "upload_file":
+            buckets.upload += 1;
+            return;
+        case "wait":
+        case "sleep":
+            buckets.wait += 1;
+            return;
+        case "win_ui_inspect":
+            buckets.inspect += 1;
+            return;
+        case "click":
+        case "double_click":
+        case "right_click":
+        case "tap":
+            if (isCommitClick(args))
+                buckets.commit += 1;
+            else
+                buckets.click += 1;
+            return;
+        case "keystroke":
+        case "hotkey":
+            if (isCommitKey(args))
+                buckets.commit += 1;
+            else
+                buckets.keystroke += 1;
+            return;
+        case "win_ui_automate": {
+            // Sub-action lives in args.action for UIA dispatch.
+            const sub = args.action?.toLowerCase() ?? "";
+            if (sub === "setvalue" || sub === "set_value") {
+                buckets.input += 1;
+            }
+            else if (sub === "toggle") {
+                buckets.toggle += 1;
+            }
+            else if (sub === "invoke") {
+                // Invoke on a UIA button — treat like a click; flag commits via name hint.
+                if (isCommitClick(args))
+                    buckets.commit += 1;
+                else
+                    buckets.click += 1;
+            }
+            else {
+                buckets.other += 1;
+            }
+            return;
+        }
+        default:
+            buckets.other += 1;
+            return;
+    }
+}
+function parseLogFile(path) {
+    try {
+        const raw = readFileSync(path, "utf-8");
+        const out = [];
+        for (const line of raw.split("\n")) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            try {
+                out.push(JSON.parse(trimmed));
+            }
+            catch {
+                /* skip malformed */
+            }
+        }
+        return out;
+    }
+    catch {
+        return [];
+    }
+}
+function uniqueScreens(entries) {
+    const seen = new Set();
+    for (const e of entries) {
+        const args = e.input_args ?? {};
+        const url = typeof args.url === "string" ? args.url : "";
+        const app = typeof args.app_name === "string" ? args.app_name : "";
+        const key = url || app;
+        if (key)
+            seen.add(key);
+    }
+    return seen.size;
+}
+/**
+ * Aggregate every interaction across every run in the project's artifacts
+ * directory. Runs without logs are skipped silently.
+ */
+export function collectInteractionCoverage(cwd) {
+    const baseDir = getArtifactsBaseDir(cwd);
+    const buckets = emptyBuckets();
+    const allEntries = [];
+    if (!existsSync(baseDir)) {
+        return { total: 0, successful: 0, buckets, unique_screens: 0, depth_actions: 0 };
+    }
+    const runs = listRuns(baseDir);
+    for (const runId of runs) {
+        const logsDir = join(getRunDir(runId, baseDir), "logs");
+        if (!existsSync(logsDir))
+            continue;
+        const files = readdirSync(logsDir).filter((f) => f === "interaction_log.jsonl" || f.startsWith("interaction_log") && f.endsWith(".jsonl"));
+        for (const f of files) {
+            const entries = parseLogFile(join(logsDir, f));
+            allEntries.push(...entries);
+            for (const e of entries)
+                bucketOne(e, buckets);
+        }
+    }
+    const total = allEntries.length;
+    const successful = allEntries.filter((e) => e.success !== false).length;
+    const depthActions = buckets.navigation +
+        buckets.input +
+        buckets.commit +
+        buckets.toggle +
+        buckets.gesture +
+        buckets.upload +
+        buckets.click +
+        buckets.keystroke;
+    return {
+        total,
+        successful,
+        buckets,
+        unique_screens: uniqueScreens(allEntries),
+        depth_actions: depthActions,
+    };
+}
+/**
+ * Compare the observed coverage against the project's minimums. Returns
+ * the verdict plus a human-readable reason that lists EVERY shortfall —
+ * the agent uses this to know which buckets to fill in before re-gating.
+ */
+export function evaluateDepth(coverage, minimums) {
+    if (!minimums.enabled) {
+        return {
+            passed: true,
+            reason: "Interaction depth gate is disabled in .codeloop/config.json (interaction_depth_minimums.enabled=false).",
+            shortfalls: [],
+        };
+    }
+    const shortfalls = [];
+    const checks = [
+        { bucket: "total_successful", required: minimums.total_successful, have: coverage.successful },
+        { bucket: "input", required: minimums.input, have: coverage.buckets.input },
+        { bucket: "commit", required: minimums.commit, have: coverage.buckets.commit },
+        { bucket: "click", required: minimums.click, have: coverage.buckets.click },
+        { bucket: "navigation", required: minimums.navigation, have: coverage.buckets.navigation },
+        { bucket: "toggle", required: minimums.toggle, have: coverage.buckets.toggle },
+        { bucket: "gesture", required: minimums.gesture, have: coverage.buckets.gesture },
+        { bucket: "upload", required: minimums.upload, have: coverage.buckets.upload },
+    ];
+    for (const c of checks) {
+        if (c.required > 0 && c.have < c.required)
+            shortfalls.push(c);
+    }
+    if (shortfalls.length === 0) {
+        const b = coverage.buckets;
+        return {
+            passed: true,
+            reason: `Deep interaction coverage met: ${coverage.successful} successful actions (click=${b.click}, navigation=${b.navigation}, input=${b.input}, commit=${b.commit}, toggle=${b.toggle}, gesture=${b.gesture}, upload=${b.upload}).`,
+            shortfalls: [],
+        };
+    }
+    const lines = shortfalls.map((s) => `  - ${s.bucket}: need >= ${s.required}, have ${s.have}`);
+    const hint = buildHint(shortfalls);
+    return {
+        passed: false,
+        reason: `Deep interaction coverage NOT met. Shortfalls:\n${lines.join("\n")}\n${hint}`,
+        shortfalls,
+    };
+}
+function buildHint(shortfalls) {
+    const tips = [];
+    const has = (b) => shortfalls.some((s) => s.bucket === b);
+    if (has("input")) {
+        tips.push('Fill input fields with codeloop_interact action: "type" or "fill_form" (or "win_ui_automate" with action: "setValue" on a WPF TextBox).');
+    }
+    if (has("commit")) {
+        tips.push('Submit at least one form: click a button whose name contains submit/save/update/login/signup, or send action "type_and_submit" / "hotkey" enter after typing.');
+    }
+    if (has("toggle")) {
+        tips.push('Exercise a toggle, switch, or dropdown via action: "toggle" / "select_option" (or "win_ui_automate" with action: "toggle" on a ToggleSwitch).');
+    }
+    if (has("click")) {
+        tips.push('Click more interactive elements — buttons, list items, expanders, tabs. Pure navigation does not count toward click coverage.');
+    }
+    if (has("navigation")) {
+        tips.push('Visit more screens. Use action: "navigate_url" for web, "click" on sidebar/menu items for desktop, "deep_link" for mobile.');
+    }
+    if (has("gesture")) {
+        tips.push('Add at least one gesture: scroll (action: "scroll"), drag (action: "drag_drop"), swipe (action: "swipe" on mobile), or hover (action: "hover").');
+    }
+    if (has("upload")) {
+        tips.push('Exercise a file upload via action: "upload_file".');
+    }
+    if (has("total_successful")) {
+        tips.push("Overall successful-interaction count is too low; combine the above to reach the minimum.");
+    }
+    return tips.length > 0 ? `Next steps:\n  * ${tips.join("\n  * ")}` : "";
+}
+/**
+ * Merge user-supplied minimums onto DEFAULT_DEPTH_MINIMUMS. Unknown / non-numeric
+ * fields fall back to the default.
+ */
+export function resolveDepthMinimums(override) {
+    if (!override)
+        return DEFAULT_DEPTH_MINIMUMS;
+    const out = { ...DEFAULT_DEPTH_MINIMUMS };
+    if (typeof override.enabled === "boolean")
+        out.enabled = override.enabled;
+    const numFields = [
+        "total_successful",
+        "input",
+        "commit",
+        "click",
+        "navigation",
+        "toggle",
+        "gesture",
+        "upload",
+    ];
+    for (const k of numFields) {
+        const v = override[k];
+        if (typeof v === "number" && v >= 0 && Number.isFinite(v)) {
+            out[k] = v;
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=interaction_coverage.js.map

package/dist/evidence/interaction_coverage.js.map

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

package/dist/index.js

@@ -313,6 +313,7 @@ Returns: per-screen pixel diff scores + worst-failing reference, actual, and dif
     figma_file_url: z.string().optional().describe("Figma file URL or key. Triggers a Figma sync into designs/ before comparing."),
     figma_token: z.string().optional().describe("Figma personal access token. Falls back to FIGMA_API_TOKEN env var."),
     designs_dir: z.string().optional().describe("Override the default designs/ folder."),
+    run_id: z.string().optional().describe("Explicit run_id whose screenshots/ folder should be the source of actuals. When omitted, design_compare picks the newest run that has PNGs. Honour this when the caller has just captured fresh screenshots into a specific run so a stale or seed run cannot shadow the comparison."),
     project_dir: z.string().optional().describe("Absolute path to the project root. Defaults to CODELOOP_PROJECT_DIR or cwd."),
 }, async (params) => {
     const authResult = await withAuth(async () => {
@@ -327,6 +328,7 @@ Returns: per-screen pixel diff scores + worst-failing reference, actual, and dif
             figma_file_url: params.figma_file_url,
             figma_token: params.figma_token,
             designs_dir: params.designs_dir,
+            run_id: params.run_id,
         };
         const cwd = params.project_dir || projectDir;
         const result = await runDesignCompare(input, config, cwd);
@@ -1287,6 +1289,10 @@ Returns: checklist of completed and pending verification steps.`, {
         const coveredRoutes = new Set();
         let discoveredRoutes = [];
         let uncoveredRoutes = [];
+        // Deep-interaction bucket breakdown — set even for non-UI projects so
+        // the diagnostic step can show "n/a" with the same shape.
+        let depthDetail = "Not a UI project — interaction depth not applicable";
+        let depthStatus = "n/a";
         if (isUIProject) {
             try {
                 const { readFileSync: rfs } = await import("fs");
@@ -1319,6 +1325,28 @@ Returns: checklist of completed and pending verification steps.`, {
                 uncoveredRoutes = discoveredRoutes.filter(route => {
                     return !coveredRoutes.has(route) && ![...coveredRoutes].some(c => c.includes(route) || route.includes(c));
                 });
+                // Deep-interaction depth check — same machinery the
+                // interaction_depth_evidence gate uses, surfaced HERE so the
+                // agent sees "input=1, commit=0 — need >= 3 / >= 1" BEFORE
+                // calling gate_check and gets a structured next step.
+                const { collectInteractionCoverage, evaluateDepth, resolveDepthMinimums, } = await import("./evidence/interaction_coverage.js");
+                const minimums = resolveDepthMinimums(config.interaction_depth_minimums);
+                const coverage = collectInteractionCoverage(cwd);
+                const verdict = evaluateDepth(coverage, minimums);
+                const b = coverage.buckets;
+                const breakdown = `click=${b.click}, navigation=${b.navigation}, input=${b.input}, commit=${b.commit}, toggle=${b.toggle}, gesture=${b.gesture}, upload=${b.upload}, keystroke=${b.keystroke}, inspect=${b.inspect}`;
+                if (!minimums.enabled) {
+                    depthStatus = "n/a";
+                    depthDetail = `Depth gate disabled in .codeloop/config.json. Observed buckets: ${breakdown}.`;
+                }
+                else if (verdict.passed) {
+                    depthStatus = "done";
+                    depthDetail = `${coverage.successful} successful interactions across ${runs.length} run(s) (${breakdown}). Depth minimums met.`;
+                }
+                else {
+                    depthStatus = "PENDING";
+                    depthDetail = `${coverage.successful} successful interactions across ${runs.length} run(s) (${breakdown}). ${verdict.reason}`;
+                }
             }
             catch { /* best-effort coverage check */ }
         }
@@ -1381,6 +1409,11 @@ Returns: checklist of completed and pending verification steps.`, {
                             ? `All ${discoveredRoutes.length} discovered routes covered by ${interactionCount} interactions`
                             : `${uncoveredRoutes.length} of ${discoveredRoutes.length} routes NOT covered by interactions. Uncovered: ${uncoveredRoutes.join(", ")}. Navigate to these routes and interact with their elements.`,
             },
+            {
+                step: "7. Deep interaction depth",
+                status: depthStatus,
+                detail: depthDetail,
+            },
         ];
         const pendingSteps = steps.filter(s => s.status === "PENDING" || s.status === "NEEDS_RERUN");
         const allDone = pendingSteps.length === 0;