codeloop-mcp-server 0.1.52 → 0.1.54

package/dist/evidence/cycle_issues.js

@@ -0,0 +1,120 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { getArtifactsBaseDir, getRunDir, listRuns } from "./artifacts.js";
+function findLatestRunDir(workspaceRoot) {
+    const base = getArtifactsBaseDir(workspaceRoot);
+    const runs = listRuns(base);
+    if (runs.length === 0)
+        return undefined;
+    return getRunDir(runs[0], base);
+}
+const CYCLE_ISSUES_FILE = "cycle_issues.jsonl";
+const CYCLE_RESOLUTIONS_FILE = "cycle_issue_resolutions.jsonl";
+async function resolveLogsDir(workspaceRoot) {
+    const runDir = findLatestRunDir(workspaceRoot);
+    if (!runDir)
+        return undefined;
+    const logsDir = path.join(runDir, "logs");
+    await fs.mkdir(logsDir, { recursive: true });
+    return logsDir;
+}
+/**
+ * Append a cycle issue to <run>/logs/cycle_issues.jsonl. Best-effort —
+ * if no run directory exists yet (caller fired before
+ * codeloop_start_recording set one up), the call is a silent no-op.
+ */
+export async function recordCycleIssue(workspaceRoot, issue) {
+    try {
+        const logsDir = await resolveLogsDir(workspaceRoot);
+        if (!logsDir)
+            return;
+        const file = path.join(logsDir, CYCLE_ISSUES_FILE);
+        const line = JSON.stringify({ ...issue, timestamp: new Date().toISOString() }) + "\n";
+        await fs.appendFile(file, line, "utf-8");
+    }
+    catch {
+        // intentional: never let evidence writes throw out of a tool path.
+    }
+}
+/**
+ * Append a resolution. Used both by the agent (via gate_check
+ * acknowledgment) and implicitly by tools (e.g. kill_modal_window
+ * succeeding clears modal_close_failed).
+ */
+export async function recordCycleIssueResolution(workspaceRoot, resolution) {
+    try {
+        const logsDir = await resolveLogsDir(workspaceRoot);
+        if (!logsDir)
+            return;
+        const file = path.join(logsDir, CYCLE_RESOLUTIONS_FILE);
+        const line = JSON.stringify({ ...resolution, timestamp: new Date().toISOString() }) +
+            "\n";
+        await fs.appendFile(file, line, "utf-8");
+    }
+    catch {
+        /* swallow */
+    }
+}
+async function readJsonl(filePath) {
+    try {
+        const raw = await fs.readFile(filePath, "utf-8");
+        return raw
+            .split("\n")
+            .map((line) => line.trim())
+            .filter((line) => line.length > 0)
+            .map((line) => {
+            try {
+                return JSON.parse(line);
+            }
+            catch {
+                return null;
+            }
+        })
+            .filter((entry) => entry !== null);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Load cycle_issues + resolutions from the latest run. Used by the
+ * gate_check `cycle_issues_acknowledged` blocker.
+ */
+export async function loadCycleIssues(workspaceRoot) {
+    const runDir = findLatestRunDir(workspaceRoot);
+    const empty = { issues: [], resolutions: [], unresolved: [] };
+    if (!runDir)
+        return empty;
+    const logsDir = path.join(runDir, "logs");
+    const issuesFile = path.join(logsDir, CYCLE_ISSUES_FILE);
+    const resolutionsFile = path.join(logsDir, CYCLE_RESOLUTIONS_FILE);
+    const [issues, resolutions] = await Promise.all([
+        readJsonl(issuesFile),
+        readJsonl(resolutionsFile),
+    ]);
+    // Resolution match is by kind. We deliberately stay simple — one
+    // resolution of kind X clears all currently-recorded issues of kind X.
+    // The gate's directive tells the agent to acknowledge each kind
+    // explicitly, which makes per-instance tracking unnecessary.
+    const resolvedKinds = new Set(resolutions.map((r) => r.issue_kind));
+    const unresolved = issues.filter((i) => !resolvedKinds.has(i.kind));
+    return { issues, resolutions, unresolved };
+}
+/**
+ * Render a one-line summary of an issue for the gate-check directive.
+ */
+export function summariseCycleIssue(issue) {
+    switch (issue.kind) {
+        case "click_missed_target":
+            return `click_missed_target — ${issue.description ?? issue.selector ?? `coords ${JSON.stringify(issue.coords ?? null)}`}${issue.modal_kind ? ` (modal_kind=${issue.modal_kind})` : ""}`;
+        case "modal_close_failed":
+            return `modal_close_failed — kind=${issue.modal_kind}, tried=[${issue.strategies_tried.join(", ")}], hwnd=${issue.hwnd ?? "n/a"}`;
+        case "app_restart_during_recording":
+            return `app_restart_during_recording — ${issue.reason}`;
+        case "binary_mismatch":
+            return `binary_mismatch — target=${issue.target_app}, binary mtime=${issue.binary_mtime}, source mtime=${issue.newest_source_mtime} (lag=${issue.lag_seconds}s)`;
+        case "high_failure_rate":
+            return `high_failure_rate — ${issue.failed}/${issue.total} attempts failed (${(issue.ratio * 100).toFixed(1)}%)`;
+    }
+}
+//# sourceMappingURL=cycle_issues.js.map

package/dist/evidence/cycle_issues.js.map

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

package/dist/evidence/evidence_freshness.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Walk depth=2 of the project to find the newest source-file mtime. Mirrors
+ * verify_staleness.ts intentionally — both signals are coarse and meant to
+ * fire on every edit at workspace-root or first-level package directory.
+ */
+export declare function newestSourceMtime(cwd: string): {
+    path: string;
+    mtimeMs: number;
+} | null;
+/**
+ * Best-effort mtime for a run's content. Prefers the latest mtime across
+ * the run's `videos/`, `logs/`, `screenshots/`, and `replay_frames/`
+ * subdirectories so we don't get tricked when the run dir itself was
+ * created early but the actual evidence was written hours later. Falls
+ * back to the run dir mtime when no content subdir exists.
+ */
+export declare function runEvidenceMtime(runDir: string): number;
+export interface FreshnessVerdict {
+    /** true when the source code changed AFTER the evidence was captured. */
+    stale: boolean;
+    source_path: string | null;
+    source_mtime_iso: string | null;
+    evidence_mtime_iso: string | null;
+    delta_minutes: number;
+}
+export declare function isEvidenceStale(cwd: string, evidenceMtimeMs: number): FreshnessVerdict;
+/**
+ * Convenience helper for callers that already know which run id they're
+ * about to credit. Resolves the run dir, computes its evidence mtime,
+ * and runs the staleness check in one call.
+ */
+export declare function isRunEvidenceStale(cwd: string, runId: string): FreshnessVerdict;
+/**
+ * Format the staleness verdict into a single line suitable for appending
+ * to a gate's reason string. Returns an empty string when the verdict is
+ * fresh.
+ */
+export declare function formatStalenessSuffix(v: FreshnessVerdict): string;
+//# sourceMappingURL=evidence_freshness.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"evidence_freshness.d.ts","sourceRoot":"","sources":["../../src/evidence/evidence_freshness.ts"],"names":[],"mappings":"AAyEA;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAiCvF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAyCvD;AAED,MAAM,WAAW,gBAAgB;IAC/B,yEAAyE;IACzE,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,aAAa,EAAE,MAAM,CAAC;CACvB;AAeD,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,eAAe,EAAE,MAAM,GACtB,gBAAgB,CA4BlB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAI/E;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAOjE"}

package/dist/evidence/evidence_freshness.js

@@ -0,0 +1,231 @@
+import { existsSync, readdirSync, statSync } from "fs";
+import { join } from "path";
+import { getArtifactsBaseDir, getRunDir } from "./artifacts.js";
+/**
+ * 0.1.53 D2 — Evidence freshness.
+ *
+ * The Photometry-DB E2E #10 transcript shipped at 100% confidence with all
+ * 11 gates green even though the agent NEVER re-recorded after adding the
+ * Product Name / Product Code column to the Luminaire export pipeline. The
+ * gate accepted:
+ *
+ *   - video_evidence: "1 video(s) recorded in sibling run …_s6nzg8
+ *     (28 min before this gate run)"
+ *   - interaction_depth_evidence: 440 successful actions (from sibling run)
+ *   - user_journey_evidence: full_arcs=1 (from sibling run)
+ *
+ * — all mined from a recording that pre-dated the source-file changes by
+ * ~30 minutes. The 0.1.51 cross-run fallback (`MAX_SIBLING_AGE_MS = 1 hour`
+ * relative to NOW) was meant to keep the gate from blowing up when an agent
+ * starts the recording in a separate run from the verify, but it has no
+ * concept of "the source code changed between the recording and the gate".
+ *
+ * D2 closes that gap by anchoring evidence to source-file mtime, NOT to
+ * wall-clock now:
+ *
+ *   - Walk source files (depth-2, same SKIP_DIRS as H2) for the newest
+ *     mtime.
+ *   - For every sibling run we'd otherwise credit (video, interaction
+ *     log, replay frames), require the run's directory mtime to be
+ *     >= newest source-file mtime, otherwise the evidence is STALE and
+ *     the gate must reject it.
+ *   - The gate's reason string surfaces both timestamps so the agent
+ *     can tell at a glance "my recording is from 2:14 PM but I edited
+ *     PhotometricDataViewModel.cs at 2:42 PM — I need to re-record".
+ */
+const SKIP_DIRS = new Set([
+    "node_modules",
+    ".git",
+    ".vs",
+    ".idea",
+    ".vscode",
+    ".codeloop",
+    "artifacts",
+    "dist",
+    "build",
+    "out",
+    "bin",
+    "obj",
+    "Pods",
+    ".next",
+    ".turbo",
+    ".cache",
+    ".gradle",
+    "DerivedData",
+    "__pycache__",
+    "target",
+    ".venv",
+    "venv",
+]);
+const SKIP_FILE_PATTERNS = [
+    /^\.DS_Store$/,
+    /^Thumbs\.db$/,
+    /^package-lock\.json$/,
+    /^pnpm-lock\.yaml$/,
+    /^yarn\.lock$/,
+    /^poetry\.lock$/,
+    /^Cargo\.lock$/,
+    /\.log$/,
+];
+/**
+ * Walk depth=2 of the project to find the newest source-file mtime. Mirrors
+ * verify_staleness.ts intentionally — both signals are coarse and meant to
+ * fire on every edit at workspace-root or first-level package directory.
+ */
+export function newestSourceMtime(cwd) {
+    let newest = null;
+    function visit(dir, depth) {
+        if (depth > 2)
+            return;
+        let entries;
+        try {
+            entries = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const ent of entries) {
+            const name = ent.name;
+            if (SKIP_DIRS.has(name))
+                continue;
+            const p = join(dir, name);
+            if (ent.isDirectory()) {
+                visit(p, depth + 1);
+            }
+            else if (ent.isFile()) {
+                if (SKIP_FILE_PATTERNS.some((re) => re.test(name)))
+                    continue;
+                try {
+                    const ms = statSync(p).mtimeMs;
+                    if (!newest || ms > newest.mtimeMs) {
+                        newest = { path: p, mtimeMs: ms };
+                    }
+                }
+                catch {
+                    /* skip unreadable */
+                }
+            }
+        }
+    }
+    if (existsSync(cwd))
+        visit(cwd, 0);
+    return newest;
+}
+/**
+ * Best-effort mtime for a run's content. Prefers the latest mtime across
+ * the run's `videos/`, `logs/`, `screenshots/`, and `replay_frames/`
+ * subdirectories so we don't get tricked when the run dir itself was
+ * created early but the actual evidence was written hours later. Falls
+ * back to the run dir mtime when no content subdir exists.
+ */
+export function runEvidenceMtime(runDir) {
+    if (!existsSync(runDir))
+        return 0;
+    let max = 0;
+    const candidates = ["videos", "logs", "screenshots", "replay_frames"];
+    for (const sub of candidates) {
+        const p = join(runDir, sub);
+        if (!existsSync(p))
+            continue;
+        try {
+            const ms = statSync(p).mtimeMs;
+            if (ms > max)
+                max = ms;
+        }
+        catch {
+            /* ignore */
+        }
+        // Walk one level into the subdir so we pick up the actual file
+        // mtimes — Windows doesn't always update the directory mtime when
+        // a single file inside it is rewritten.
+        try {
+            const entries = readdirSync(p);
+            for (const e of entries) {
+                try {
+                    const ms = statSync(join(p, e)).mtimeMs;
+                    if (ms > max)
+                        max = ms;
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    if (max === 0) {
+        try {
+            max = statSync(runDir).mtimeMs;
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    return max;
+}
+/**
+ * Compare evidence-run mtime against newest source-file mtime. The verdict
+ * is "stale" when the source changed at least 60 seconds AFTER the
+ * evidence was captured — the 60-second buffer is to absorb clock drift
+ * between Cursor's file-watcher and the recording subprocess on Windows.
+ *
+ * `evidenceMtimeMs === 0` means we couldn't find any evidence on disk;
+ * we treat that as `stale: false` because the parent gate already has a
+ * "no evidence found" failure mode and we don't want two gates failing
+ * with overlapping reasons.
+ */
+const STALE_BUFFER_MS = 60_000;
+export function isEvidenceStale(cwd, evidenceMtimeMs) {
+    if (evidenceMtimeMs === 0) {
+        return {
+            stale: false,
+            source_path: null,
+            source_mtime_iso: null,
+            evidence_mtime_iso: null,
+            delta_minutes: 0,
+        };
+    }
+    const newest = newestSourceMtime(cwd);
+    if (!newest) {
+        return {
+            stale: false,
+            source_path: null,
+            source_mtime_iso: null,
+            evidence_mtime_iso: new Date(evidenceMtimeMs).toISOString(),
+            delta_minutes: 0,
+        };
+    }
+    const stale = newest.mtimeMs > evidenceMtimeMs + STALE_BUFFER_MS;
+    return {
+        stale,
+        source_path: newest.path,
+        source_mtime_iso: new Date(newest.mtimeMs).toISOString(),
+        evidence_mtime_iso: new Date(evidenceMtimeMs).toISOString(),
+        delta_minutes: Math.round((newest.mtimeMs - evidenceMtimeMs) / 60_000),
+    };
+}
+/**
+ * Convenience helper for callers that already know which run id they're
+ * about to credit. Resolves the run dir, computes its evidence mtime,
+ * and runs the staleness check in one call.
+ */
+export function isRunEvidenceStale(cwd, runId) {
+    const baseDir = getArtifactsBaseDir(cwd);
+    const runDir = getRunDir(runId, baseDir);
+    return isEvidenceStale(cwd, runEvidenceMtime(runDir));
+}
+/**
+ * Format the staleness verdict into a single line suitable for appending
+ * to a gate's reason string. Returns an empty string when the verdict is
+ * fresh.
+ */
+export function formatStalenessSuffix(v) {
+    if (!v.stale)
+        return "";
+    const newer = v.source_path ? ` (newest source: ${v.source_path})` : "";
+    return (` STALE: source code changed ${v.delta_minutes} min after the evidence ` +
+        `was captured${newer}. Re-record AFTER the latest edit before re-gating.`);
+}
+//# sourceMappingURL=evidence_freshness.js.map

package/dist/evidence/evidence_freshness.js.map

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

package/dist/evidence/interaction_coverage.d.ts

@@ -108,6 +108,21 @@ export interface DepthVerdict {
         required: number;
         have: number;
     }>;
+    /**
+     * 0.1.54 E6 — Soft warning surfaced alongside the depth verdict when
+     * more than 10% of attempted interactions failed. The depth gate itself
+     * still passes if successful counts meet minimums; the warning gives
+     * the agent signal that "successful clicks aren't landing where you
+     * think they are" so they can fix bad-coordinate / unresolved-selector
+     * loops instead of repeatedly hammering the same dead spot.
+     */
+    failure_rate_warning?: {
+        failed: number;
+        successful: number;
+        total: number;
+        ratio: number;
+        message: string;
+    };
 }
 /**
  * Compare the observed coverage against the project's minimums. Returns

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

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

package/dist/evidence/interaction_coverage.js

@@ -69,6 +69,16 @@ function isCommitKey(args) {
     return /(?:^|[+ ])(enter|return)$/.test(key) || /(?:^|[+ ])(enter|return)$/.test(combo);
 }
 function bucketOne(entry, buckets) {
+    // 0.1.54 E5 — skip non-interaction log entries (replay-frame markers,
+    // pure console_error rollups, runtime-log entries) that share the
+    // interaction_log.jsonl file. An "interaction" entry must have a
+    // string `action` AND an object `input_args` — anything else is
+    // structural noise that historically polluted the "undefined" bucket
+    // (Photometry-DB E2E #11 had 150/560 entries hit "undefined").
+    if (typeof entry.action !== "string" || entry.action.length === 0)
+        return;
+    if (entry.input_args === null || typeof entry.input_args !== "object")
+        return;
     const action = (entry.action ?? "").toLowerCase();
     const args = entry.input_args ?? {};
     const success = entry.success !== false; // default to true when absent
@@ -343,8 +353,16 @@ export function collectInteractionCoverage(cwd) {
         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)
+            // 0.1.54 E5 — gate non-interaction rows BEFORE pushing them into
+            // the aggregate. The same predicate as bucketOne so the depth
+            // gate's `successful` count and the dev-report breakdown agree
+            // on what counts as an interaction.
+            const real = entries.filter((e) => typeof e.action === "string" &&
+                e.action.length > 0 &&
+                e.input_args !== null &&
+                typeof e.input_args === "object");
+            allEntries.push(...real);
+            for (const e of real)
                 bucketOne(e, buckets);
         }
     }
@@ -518,12 +536,39 @@ export function evaluateDepth(coverage, minimums, discovery) {
             shortfalls.push(c);
         }
     }
+    // 0.1.54 E6 — Failed-interaction-rate warning. When the recording shows
+    // more than 10% of attempts failing, append a soft warning to the gate
+    // reason and surface the structured `failure_rate_warning` so the gate
+    // wrapper can also write a `high_failure_rate` cycle_issue. We
+    // intentionally do NOT block the depth gate on this — the depth gate's
+    // job is bucket coverage; failed clicks usually mean bad coordinates or
+    // unresolved selectors and the right fix is to inspect the modal /
+    // re-resolve the element, not to demand more attempts.
+    const failed = Math.max(0, coverage.total - coverage.successful);
+    const denom = failed + coverage.successful;
+    const ratio = denom > 0 ? failed / denom : 0;
+    const failureRateWarning = ratio > 0.1 && denom >= 10
+        ? {
+            failed,
+            successful: coverage.successful,
+            total: denom,
+            ratio,
+            message: `WARN: high interaction failure rate (${(ratio * 100).toFixed(1)}% — ${failed} of ${denom} attempts failed). ` +
+                `The agent may be clicking coordinates that miss their target; run codeloop_handle_modal to clear any blocking dialog, ` +
+                `or re-inspect with codeloop_interact action: "win_ui_inspect" to get a fresh AutomationId before the next attempt. ` +
+                `Re-running the same coordinate click is unlikely to start working without first changing what you're targeting.`,
+        }
+        : undefined;
     if (shortfalls.length === 0) {
         const b = coverage.buckets;
+        let 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}).`;
+        if (failureRateWarning)
+            reason += `\n${failureRateWarning.message}`;
         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}).`,
+            reason,
             shortfalls: [],
+            failure_rate_warning: failureRateWarning,
         };
     }
     const lines = shortfalls.map((s) => `  - ${s.bucket}: need >= ${s.required}, have ${s.have}`);
@@ -541,10 +586,14 @@ export function evaluateDepth(coverage, minimums, discovery) {
                 `These are invisible to the CRUD classifier (edit_arcs / delete_actions / create signals can't be credited from a bare coordinate click). ` +
                 "When you have to use coordinates because UIA can't resolve the element, ALSO pass an `intent` (e.g. \"confirm delete\"), `description` (\"click Yes on delete confirmation dialog\"), or `purpose` field to codeloop_interact so the classifier still credits the arc.";
     }
+    let failReason = `Deep interaction coverage NOT met. Shortfalls:\n${lines.join("\n")}\n${hint}${coordinateHint}`;
+    if (failureRateWarning)
+        failReason += `\n${failureRateWarning.message}`;
     return {
         passed: false,
-        reason: `Deep interaction coverage NOT met. Shortfalls:\n${lines.join("\n")}\n${hint}${coordinateHint}`,
+        reason: failReason,
         shortfalls,
+        failure_rate_warning: failureRateWarning,
     };
 }
 function buildHint(shortfalls) {