codeloop-mcp-server 0.1.91 → 0.1.96

package/dist/evidence/interaction_evidence.js

@@ -17,6 +17,46 @@
 import { existsSync, readFileSync, writeFileSync, readdirSync, statSync } from "fs";
 import { join } from "path";
 const FILE = "interaction_evidence.json";
+/**
+ * P5.4 — per-platform confidence breakdown from a multi-platform journey's
+ * evidence. Scoring (drive-completeness only — build/tests/lint gates are
+ * platform-agnostic and stay in the monolithic score):
+ *   launch_failed → 0, device_required → 10;
+ *   completed → 60 base + up to 20 for flow pass-rate (full marks when no
+ *   label flows ran but steps drove) + 20 for screenshots.
+ */
+export function computePlatformBreakdown(per) {
+    return per.map((p) => {
+        if (p.status !== "completed") {
+            const isLaunch = p.status === "launch_failed";
+            return {
+                target: p.target,
+                status: p.status,
+                score: isLaunch ? 0 : 10,
+                driven_steps: p.driven_steps,
+                screenshots: p.screenshots,
+                fix_hint: isLaunch
+                    ? `${p.target}: the app did not launch — fix the build/launch blocker for this platform (see the journey's launch notes), then re-run codeloop_verify.`
+                    : `${p.target}: no device was available — boot one (or configure e2e.android_avd / e2e.ios_device), then re-run codeloop_verify.`,
+            };
+        }
+        const flowsTotal = p.mobile_flows_total ?? 0;
+        const flowRatio = flowsTotal > 0 ? (p.mobile_flows_passed ?? 0) / flowsTotal : p.driven_steps > 0 ? 1 : 0;
+        const score = Math.round(60 + 20 * flowRatio + (p.screenshots > 0 ? 20 : 0));
+        const weak = score < 100;
+        return {
+            target: p.target,
+            status: p.status,
+            score,
+            driven_steps: p.driven_steps,
+            screenshots: p.screenshots,
+            flows: flowsTotal > 0 ? `${p.mobile_flows_passed ?? 0}/${flowsTotal}` : undefined,
+            fix_hint: weak
+                ? `${p.target}: drove but incompletely (${flowsTotal > 0 ? `flows ${p.mobile_flows_passed ?? 0}/${flowsTotal}` : `${p.driven_steps} step(s)`}, ${p.screenshots} screenshot(s)) — check the failed flow labels / missing screenshots for this platform.`
+                : undefined,
+        };
+    });
+}
 /** Persist a run_journey interaction-evidence record into its run dir. */
 export function writeInteractionEvidence(runDir, ev) {
     try {
@@ -64,6 +104,26 @@ export function evaluateInteractionEvidenceGate(input) {
     const { journeyEvidence, journeyStale, hasManualInteractionLogs } = input;
     if (journeyEvidence && !journeyStale) {
         const e = journeyEvidence.evidence;
+        // P5.3 — multi-platform record: every configured platform must have
+        // completed with driven evidence. A launch_failed iOS leg must fail the
+        // gate even when the Android leg drove fine.
+        if (e.per_platform && e.per_platform.length > 0) {
+            const summary = e.per_platform
+                .map((p) => p.status === "completed"
+                ? `${p.target}: ${p.driven_steps} step(s), ${p.screenshots} screenshot(s)${p.mobile_engine ? ` via ${p.mobile_engine}` : ""}`
+                : `${p.target}: ${p.status.toUpperCase()}`)
+                .join("; ");
+            const failing = e.per_platform.filter((p) => p.status !== "completed" || (p.driven_steps === 0 && p.screenshots === 0));
+            if (failing.length === 0) {
+                return { passed: true, reason: `codeloop_run_journey drove ALL configured platforms — ${summary}.` };
+            }
+            return {
+                passed: false,
+                reason: `Multi-platform run (e2e.platforms) is INCOMPLETE — ${summary}. ` +
+                    `Every configured platform must produce driven evidence: fix ${failing.map((p) => p.target).join(", ")} ` +
+                    `(or remove it from e2e.platforms), then re-run codeloop_verify.`,
+            };
+        }
         const mobile = e.mobile_engine
             ? ` (mobile engine: ${e.mobile_engine}${e.mobile_flows_total != null ? `, ${e.mobile_flows_passed ?? 0}/${e.mobile_flows_total} flow(s)` : ""})`
             : "";

package/dist/evidence/interaction_evidence.js.map

@@ -1 +1 @@
-{"version":3,"file":"interaction_evidence.js","sourceRoot":"","sources":["../../src/evidence/interaction_evidence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AACpF,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAkB5B,MAAM,IAAI,GAAG,2BAA2B,CAAC;AAEzC,0EAA0E;AAC1E,MAAM,UAAU,wBAAwB,CAAC,MAAc,EAAE,EAAuB;IAC9E,IAAI,CAAC;QACH,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,iBAAiB;IACnB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,6BAA6B,CAC3C,gBAAwB;IAExB,IAAI,IAAI,GAA8D,IAAI,CAAC;IAC3E,IAAI,OAAO,GAAa,EAAE,CAAC;IAC3B,IAAI,CAAC;QACH,OAAO,GAAG,WAAW,CAAC,gBAAgB,CAAC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,CAAC,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;YAAE,SAAS;QAC7B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAwB,CAAC;YAC7E,IAAI,CAAC,IAAI,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO;gBAAE,IAAI,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;QACpE,CAAC;QAAC,MAAM,CAAC;YACP,qBAAqB;QACvB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAeD;;;;GAIG;AACH,MAAM,UAAU,+BAA+B,CAAC,KAA2B;IACzE,MAAM,EAAE,eAAe,EAAE,YAAY,EAAE,wBAAwB,EAAE,GAAG,KAAK,CAAC;IAC1E,IAAI,eAAe,IAAI,CAAC,YAAY,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,eAAe,CAAC,QAAQ,CAAC;QACnC,MAAM,MAAM,GAAG,CAAC,CAAC,aAAa;YAC5B,CAAC,CAAC,oBAAoB,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC,kBAAkB,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,mBAAmB,IAAI,CAAC,IAAI,CAAC,CAAC,kBAAkB,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG;YAChJ,CAAC,CAAC,EAAE,CAAC;QACP,OAAO;YACL,MAAM,EAAE,IAAI;YACZ,MAAM,EAAE,8BAA8B,CAAC,CAAC,YAAY,eAAe,CAAC,CAAC,MAAM,GAAG,MAAM,KAAK,CAAC,CAAC,WAAW,iBAAiB;SACxH,CAAC;IACJ,CAAC;IACD,IAAI,wBAAwB,EAAE,CAAC;QAC7B,OAAO;YACL,MAAM,EAAE,IAAI;YACZ,MAAM,EAAE,8FAA8F;SACvG,CAAC;IACJ,CAAC;IACD,IAAI,eAAe,IAAI,YAAY,EAAE,CAAC;QACpC,OAAO;YACL,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,qHAAqH;SAC9H,CAAC;IACJ,CAAC;IACD,OAAO;QACL,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,2IAA2I;KACpJ,CAAC;AACJ,CAAC"}
+{"version":3,"file":"interaction_evidence.js","sourceRoot":"","sources":["../../src/evidence/interaction_evidence.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,3 +1,5 @@
 #!/usr/bin/env node
+declare const androidSdkResolution: import("./runners/android_sdk.js").AndroidSdkResolution;
+export { androidSdkResolution };
 export declare function markVerifiedNow(cwd: string): void;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAimBA,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEjD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AA4QA,QAAA,MAAM,oBAAoB,yDAA6B,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,CAAC;AA6VhC,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEjD"}

package/dist/index.js

@@ -216,6 +216,14 @@ function autoCloseStuckModalsEnabled() {
 }
 /** Consecutive same-dialog detections that mark a file dialog as genuinely stuck. */
 const MODAL_AUTOCLOSE_THRESHOLD = 3;
+// P2.1 — Android Studio installs the SDK without putting platform-tools on
+// the shell PATH. Resolve ANDROID_HOME / ANDROID_SDK_ROOT / the default
+// install location ONCE at startup and append the tool dirs to PATH so every
+// adb/emulator call (ours and Maestro's) just works. Resolution details are
+// surfaced by `codeloop doctor` and Android launch errors.
+import { ensureAndroidToolsOnPath } from "./runners/android_sdk.js";
+const androidSdkResolution = ensureAndroidToolsOnPath();
+export { androidSdkResolution };
 const server = new McpServer({
     name: "codeloop",
     version: "0.1.14",
@@ -1857,20 +1865,72 @@ screens_captured[], screenshots[], unsupported_count, manual_followups[], direct
     target_type: targetTypeSchema.optional().describe("Override the auto-detected interaction target. Accepts synonyms (web→browser, android→android_emulator, ios→ios_simulator, *_desktop→desktop)."),
     web_url: z.string().optional().describe("URL to open for browser targets (e.g. http://localhost:3000). Defaults to e2e.web_url from config. Start your dev server first."),
     max_duration_seconds: z.number().int().min(10).max(600).optional().describe("Max video recording length. Default 180s."),
-}, async (params) => {
+}, async (params, extra) => {
+    // P5.5 (0.1.92) — stream journey progress (boot, build heartbeat lines,
+    // drive, capture) the same way verify streams phases, so a cold first
+    // build doesn't look like a hang. Same safety gate as verify: only when
+    // the client passed a progressToken AND is safe to stream to.
+    const progressToken = extra?._meta?.progressToken;
+    let journeyClientName;
+    try {
+        journeyClientName = server.server.getClientVersion?.()?.name;
+    }
+    catch {
+        journeyClientName = undefined;
+    }
     const result = await withAuth(async () => {
         const cwd = resolveCwd(params);
         const { loadConfig } = await import("./config.js");
         const cfg = loadConfig(cwd);
-        const { runJourney } = await import("./tools/run_journey.js");
-        return runJourney({
+        const { runJourneyForPlatforms } = await import("./tools/run_journey.js");
+        const { progressClientDecision } = await import("./tools/verify.js");
+        const progressSafe = progressClientDecision(journeyClientName, process.env.CODELOOP_PROGRESS);
+        let progressCount = 0;
+        const onProgress = !progressSafe || progressToken === undefined
+            ? undefined
+            : (u) => {
+                progressCount += 1;
+                void extra
+                    .sendNotification({
+                    method: "notifications/progress",
+                    params: {
+                        progressToken,
+                        progress: progressCount,
+                        message: `${u.phase}${u.detail ? ` — ${u.detail.slice(0, 120)}` : ""} (${Math.round(u.elapsedMs / 1000)}s)`,
+                    },
+                })
+                    .catch(() => { });
+            };
+        // P5.3 — e2e.platforms drives every listed platform sequentially; an
+        // explicit target_type argument still forces a single-platform run.
+        return runJourneyForPlatforms({
             cwd,
             e2e: { ...cfg.e2e, web_url: params.web_url ?? cfg.e2e?.web_url },
             targetApp: cfg.evidence?.target_app,
             targetType: params.target_type,
             maxDurationSeconds: params.max_duration_seconds,
+            onProgress,
         });
     }, { tool: "codeloop_run_journey", cwd: resolveCwd(params), input: params });
+    // Single-platform runs keep the legacy flat result shape; multi-platform
+    // runs return the per-platform outcome list plus a combined directive.
+    const isWrapped = result && typeof result === "object" && "outcomes" in result;
+    const wrapped = isWrapped ? result : null;
+    if (wrapped && !wrapped.multi) {
+        const single = wrapped.outcomes[0].result;
+        const directive = `\n\n${single.directive}`;
+        return {
+            content: withInitHint([{ type: "text", text: JSON.stringify(single, null, 2) + directive }]),
+        };
+    }
+    if (wrapped) {
+        const directives = wrapped.outcomes
+            .map((o) => `── ${o.platform} ──\n${o.result.directive}`)
+            .join("\n\n");
+        return {
+            content: withInitHint([{ type: "text", text: JSON.stringify(result, null, 2) + `\n\n${directives}` }]),
+        };
+    }
     const directive = result && typeof result === "object" && "directive" in result ? `\n\n${result.directive}` : "";
     return {
         content: withInitHint([{ type: "text", text: JSON.stringify(result, null, 2) + directive }]),
@@ -2110,8 +2170,11 @@ App logs (stdout, logcat, simctl log) are automatically captured alongside the v
         let binaryFreshnessDetails;
         if (targetType === "desktop" && appName) {
             try {
-                const { checkBinaryFreshness } = await import("./evidence/binary_freshness.js");
-                binaryFreshnessDetails = checkBinaryFreshness({ app_name: appName, cwd });
+                // 0.1.96 — prefer the actually-running process binary (E2E #14: the
+                // configured path pointed at a stale publish/ copy while the running
+                // app was a fresh subproject Debug build → false BINARY MISMATCH).
+                const { checkBinaryFreshnessAsync } = await import("./evidence/binary_freshness.js");
+                binaryFreshnessDetails = await checkBinaryFreshnessAsync({ app_name: appName, cwd });
                 if (binaryFreshnessDetails.stale) {
                     binaryFreshnessWarning = binaryFreshnessDetails.reason;
                     const { recordCycleIssue } = await import("./evidence/cycle_issues.js");
@@ -3063,6 +3126,18 @@ Wait 1-2 seconds between interactions so video frames capture state changes.`, {
         let windowOriginOffset = null;
         let screenshotDims = null;
         if (tt === "desktop") {
+            // P2.2 — Wayland-only Linux sessions can't be driven by xdotool.
+            // Fail fast with the remediation directive instead of letting every
+            // individual action return an unexplained success: false.
+            const { waylandDirective } = await import("./runners/wayland.js");
+            const waylandBlock = waylandDirective();
+            if (waylandBlock && action !== "wait") {
+                return {
+                    content: [
+                        { type: "text", text: JSON.stringify({ success: false, action, error: waylandBlock }, null, 2) },
+                    ],
+                };
+            }
             const appName = params.app_name || vr.getActiveRecordingAppName();
             if (appName && action !== "wait") {
                 await wm.bringAppToFront(appName);