codeloop-mcp-server 0.1.75 → 0.1.77

package/dist/runners/app_launcher.d.ts

@@ -0,0 +1,47 @@
+import type { JourneyTarget } from "./interaction_engine.js";
+export interface AppLaunchHandle {
+    /** The app is now running on the target and ready to drive. */
+    launched: boolean;
+    /** How it was launched (for logs/diagnostics). */
+    method: string;
+    /** The device id / udid / desktop device the app was launched on. */
+    device?: string;
+    /** Why launch did not happen / failed (when launched===false). */
+    reason?: string;
+    /** Tail of launcher output when a build/launch fails — real signal for the agent. */
+    error_excerpt?: string;
+    /** Stop the launched app (quit `flutter run`, kill the process). Best-effort. */
+    stop?: () => Promise<void>;
+}
+/**
+ * Map a journey target + host OS to the `flutter run -d <device>` device id.
+ * Mobile uses the booted serial/udid; desktop uses the host platform device.
+ */
+export declare function flutterDeviceId(target: JourneyTarget, bootedDevice?: string): string | null;
+/** True when the directory is a Flutter project. */
+export declare function isFlutterProject(cwd: string): boolean;
+export interface LaunchAppOptions {
+    cwd: string;
+    target: JourneyTarget;
+    /** Booted device serial/udid from bootDevice (mobile). */
+    bootedDevice?: string;
+    /** Where to tee launcher stdout/stderr (best-effort). */
+    logPath?: string;
+    /** Max time to wait for the app to come up (build can be slow). */
+    readyTimeoutMs?: number;
+    /** Optional extra args (flavor/target/dart-define). */
+    extraArgs?: string[];
+}
+/**
+ * Launch the app for an interactive journey. Returns a handle whose `stop()`
+ * quits the app. Only the Flutter path actually builds+launches today; native
+ * mobile degrades to a directive (launched:false).
+ */
+export declare function launchApp(opts: LaunchAppOptions): Promise<AppLaunchHandle>;
+/** Does the dir look like a real Gradle/Android project worth building? */
+export declare function hasAndroidGradleProject(cwd: string): boolean;
+/** Prefer an .xcworkspace, else an .xcodeproj, as the xcodebuild container. */
+export declare function buildXcodebuildContainerArgs(cwd: string): string[];
+/** Parse the first scheme name from `xcodebuild -list -json` output. */
+export declare function parseFirstScheme(jsonText: string): string | null;
+//# sourceMappingURL=app_launcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"app_launcher.d.ts","sourceRoot":"","sources":["../../src/runners/app_launcher.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAI7D,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,QAAQ,EAAE,OAAO,CAAC;IAClB,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qFAAqF;IACrF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAUD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAY3F;AAED,oDAAoD;AACpD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAErD;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,aAAa,CAAC;IACtB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAID;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAehF;AAKD,2EAA2E;AAC3E,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAW5D;AAiGD,+EAA+E;AAC/E,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAYlE;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUhE"}

package/dist/runners/app_launcher.js

@@ -0,0 +1,300 @@
+/**
+ * app_launcher — actually OPEN the app under test for the deep-E2E executor.
+ *
+ * Booting a simulator/emulator (device_probe.bootDevice) is NOT enough: a blank
+ * booted device has no app running, so there is nothing to screenshot or drive.
+ * This module performs the missing step — it BUILDS + INSTALLS + LAUNCHES the
+ * app on the resolved target so the journey has a live UI to interact with.
+ *
+ * Flutter is the primary path: `flutter run -d <device>` builds, installs, and
+ * launches on the booted emulator/simulator (or desktop), and stays attached so
+ * we can quit it cleanly afterwards. A build/launch FAILURE here is real,
+ * valuable signal ("the app doesn't even start"), surfaced as launched:false
+ * with the error tail rather than swallowed.
+ *
+ * Native iOS/Android (no Flutter) build+install is project-specific (schemes,
+ * flavors, signing); for those we degrade to launched:false + a clear directive
+ * so the agent launches the app, instead of silently driving a blank screen.
+ *
+ * Never throws; always returns a handle (with a best-effort stop()).
+ */
+import { spawn } from "child_process";
+import { existsSync, readdirSync } from "fs";
+import { join } from "path";
+import { platform } from "os";
+import { checkToolAvailable, runCommand } from "./base.js";
+import { resolveMobileAppId } from "./mobile_app_id.js";
+/** Output lines that mean the Flutter app finished launching and is live. */
+const FLUTTER_READY = /(Flutter run key commands|Dart VM Service is listening|VM Service|DevTools|is being served at|Syncing files to device|Application finished|Hot reload|Flutter DevTools|✓ +Built)/i;
+/** Output lines that mean the Flutter build/launch FAILED (don't keep waiting). */
+const FLUTTER_FAILED = /(Gradle task assemble\w+ failed|Could not build|Build failed|Error launching application|No supported devices|FAILURE: Build failed|Module '[^']+' not found|The Xcode build|Encountered error while building|Error: .*\.dart:|Target .* failed|Exception:)/i;
+/**
+ * Map a journey target + host OS to the `flutter run -d <device>` device id.
+ * Mobile uses the booted serial/udid; desktop uses the host platform device.
+ */
+export function flutterDeviceId(target, bootedDevice) {
+    if (target === "android_emulator" || target === "ios_simulator") {
+        return bootedDevice ?? null;
+    }
+    if (target === "desktop") {
+        const os = platform();
+        if (os === "darwin")
+            return "macos";
+        if (os === "win32")
+            return "windows";
+        return "linux";
+    }
+    if (target === "browser")
+        return "chrome";
+    return null;
+}
+/** True when the directory is a Flutter project. */
+export function isFlutterProject(cwd) {
+    return existsSync(join(cwd, "pubspec.yaml"));
+}
+const DEFAULT_READY_TIMEOUT_MS = 240_000; // cold build + install can take minutes
+/**
+ * Launch the app for an interactive journey. Returns a handle whose `stop()`
+ * quits the app. Only the Flutter path actually builds+launches today; native
+ * mobile degrades to a directive (launched:false).
+ */
+export async function launchApp(opts) {
+    const { cwd, target } = opts;
+    if (isFlutterProject(cwd)) {
+        return launchFlutter(opts);
+    }
+    // Native iOS / Android (no Flutter): build + install + launch best-effort.
+    if (target === "android_emulator")
+        return launchNativeAndroid(opts);
+    if (target === "ios_simulator")
+        return launchNativeIos(opts);
+    return {
+        launched: false,
+        method: "unknown",
+        reason: `No launcher for target "${target}" on a non-Flutter project — launch the app manually, then drive with codeloop_interact.`,
+    };
+}
+const NATIVE_BUILD_TIMEOUT_MS = 600_000; // native builds can be slow (cold)
+const NATIVE_CMD_TIMEOUT_MS = 90_000;
+/** Does the dir look like a real Gradle/Android project worth building? */
+export function hasAndroidGradleProject(cwd) {
+    return [
+        "gradlew",
+        "gradlew.bat",
+        "settings.gradle",
+        "settings.gradle.kts",
+        "build.gradle",
+        "build.gradle.kts",
+        join("app", "build.gradle"),
+        join("app", "build.gradle.kts"),
+    ].some((p) => existsSync(join(cwd, p)));
+}
+/** Native Android: ./gradlew :app:installDebug, then launch via monkey. */
+async function launchNativeAndroid(opts) {
+    const { cwd } = opts;
+    // Fast degrade before invoking slow Gradle when there's no project here.
+    if (!hasAndroidGradleProject(cwd)) {
+        return { launched: false, method: "native-android", reason: "No Android Gradle project found — build & install manually (./gradlew installDebug), then drive with codeloop_interact." };
+    }
+    const hasGradlew = existsSync(join(cwd, "gradlew")) || existsSync(join(cwd, "gradlew.bat"));
+    if (!hasGradlew && !(await checkToolAvailable("gradle"))) {
+        return { launched: false, method: "native-android", reason: "No gradlew/gradle found — build & install manually (./gradlew installDebug), then drive with codeloop_interact." };
+    }
+    const appId = resolveMobileAppId(cwd, "android");
+    const gradleCmd = hasGradlew ? (platform() === "win32" ? "gradlew.bat" : "./gradlew") : "gradle";
+    const install = await runCommand(gradleCmd, [":app:installDebug"], cwd, opts.logPath, undefined, opts.readyTimeoutMs ?? NATIVE_BUILD_TIMEOUT_MS);
+    if (install.exit_code !== 0) {
+        // Retry the non-scoped task name (some projects don't use :app:).
+        const retry = await runCommand(gradleCmd, ["installDebug"], cwd, opts.logPath, undefined, opts.readyTimeoutMs ?? NATIVE_BUILD_TIMEOUT_MS);
+        if (retry.exit_code !== 0) {
+            return {
+                launched: false,
+                method: "gradlew installDebug",
+                reason: "Android build/install failed — the app does not build on the emulator.",
+                error_excerpt: tail(install.stdout + install.stderr + retry.stdout + retry.stderr),
+            };
+        }
+    }
+    if (!appId) {
+        return { launched: true, method: "gradlew installDebug", device: opts.bootedDevice, reason: "Installed but could not resolve applicationId to auto-launch — open the app from the launcher (then it can be driven)." };
+    }
+    const serialArgs = opts.bootedDevice ? ["-s", opts.bootedDevice] : [];
+    await runCommand("adb", [...serialArgs, "shell", "monkey", "-p", appId, "-c", "android.intent.category.LAUNCHER", "1"], cwd, undefined, undefined, NATIVE_CMD_TIMEOUT_MS);
+    await new Promise((r) => setTimeout(r, 2500));
+    return { launched: true, method: `gradlew installDebug + launch ${appId}`, device: opts.bootedDevice };
+}
+/** Native iOS (macOS): xcodebuild -> simctl install -> simctl launch. */
+async function launchNativeIos(opts) {
+    const { cwd } = opts;
+    if (platform() !== "darwin") {
+        return { launched: false, method: "native-ios", reason: "iOS builds require macOS." };
+    }
+    // Fast degrade before invoking slow xcodebuild when there's no project here.
+    const listArgs = buildXcodebuildContainerArgs(cwd);
+    if (listArgs.length === 0) {
+        return { launched: false, method: "native-ios", reason: "No Xcode project/workspace (.xcodeproj/.xcworkspace) found to build with xcodebuild — open it and run once, or build+install manually (xcodebuild build + xcrun simctl install/launch)." };
+    }
+    if (!(await checkToolAvailable("xcodebuild")) || !(await checkToolAvailable("xcrun"))) {
+        return { launched: false, method: "native-ios", reason: "xcodebuild/xcrun not on PATH — install Xcode + command line tools." };
+    }
+    const udid = opts.bootedDevice;
+    if (!udid) {
+        return { launched: false, method: "native-ios", reason: "No booted simulator udid to install onto." };
+    }
+    const bundleId = resolveMobileAppId(cwd, "ios");
+    // Resolve a scheme from `xcodebuild -list -json`.
+    const list = await runCommand("xcodebuild", [...listArgs, "-list", "-json"], cwd, undefined, undefined, NATIVE_CMD_TIMEOUT_MS);
+    const scheme = parseFirstScheme(list.stdout);
+    if (!scheme) {
+        return { launched: false, method: "native-ios", reason: "Could not resolve an Xcode scheme — open the workspace and build/run once, or set it up, then retry.", error_excerpt: tail(list.stdout + list.stderr) };
+    }
+    const derived = join(cwd, "build", "codeloop-derived");
+    const build = await runCommand("xcodebuild", [...listArgs, "-scheme", scheme, "-configuration", "Debug", "-destination", `platform=iOS Simulator,id=${udid}`, "-derivedDataPath", derived, "build"], cwd, opts.logPath, undefined, opts.readyTimeoutMs ?? NATIVE_BUILD_TIMEOUT_MS);
+    if (build.exit_code !== 0) {
+        return { launched: false, method: `xcodebuild -scheme ${scheme}`, reason: "iOS build failed — the app does not build for the simulator.", error_excerpt: tail(build.stdout + build.stderr) };
+    }
+    const appPath = join(derived, "Build", "Products", "Debug-iphonesimulator");
+    let appBundle = null;
+    try {
+        appBundle = readdirSync(appPath).find((f) => f.endsWith(".app")) ?? null;
+    }
+    catch { /* ignore */ }
+    if (!appBundle) {
+        return { launched: false, method: "native-ios", reason: `Built but no .app found under ${appPath}.`, error_excerpt: tail(build.stdout) };
+    }
+    const fullApp = join(appPath, appBundle);
+    const installed = await runCommand("xcrun", ["simctl", "install", udid, fullApp], cwd, undefined, undefined, NATIVE_CMD_TIMEOUT_MS);
+    if (installed.exit_code !== 0) {
+        return { launched: false, method: "simctl install", reason: "simctl install failed.", error_excerpt: tail(installed.stdout + installed.stderr) };
+    }
+    if (!bundleId) {
+        return { launched: true, method: "simctl install", device: udid, reason: "Installed but could not resolve the bundle id to auto-launch — open it in the simulator." };
+    }
+    await runCommand("xcrun", ["simctl", "launch", udid, bundleId], cwd, undefined, undefined, NATIVE_CMD_TIMEOUT_MS);
+    await new Promise((r) => setTimeout(r, 2500));
+    return { launched: true, method: `xcodebuild + simctl launch ${bundleId}`, device: udid };
+}
+/** Prefer an .xcworkspace, else an .xcodeproj, as the xcodebuild container. */
+export function buildXcodebuildContainerArgs(cwd) {
+    try {
+        for (const base of [join(cwd, "ios"), cwd]) {
+            let entries = [];
+            try {
+                entries = readdirSync(base);
+            }
+            catch {
+                continue;
+            }
+            const ws = entries.find((e) => e.endsWith(".xcworkspace"));
+            if (ws)
+                return ["-workspace", join(base, ws)];
+            const proj = entries.find((e) => e.endsWith(".xcodeproj"));
+            if (proj)
+                return ["-project", join(base, proj)];
+        }
+    }
+    catch { /* ignore */ }
+    return [];
+}
+/** Parse the first scheme name from `xcodebuild -list -json` output. */
+export function parseFirstScheme(jsonText) {
+    try {
+        const obj = JSON.parse(jsonText);
+        const schemes = obj.workspace?.schemes ?? obj.project?.schemes ?? [];
+        // Prefer a non-test scheme.
+        const pick = schemes.find((s) => !/test/i.test(s)) ?? schemes[0];
+        return pick ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+function tail(s) {
+    return s.split("\n").filter(Boolean).slice(-25).join("\n");
+}
+async function launchFlutter(opts) {
+    const { cwd, target } = opts;
+    const device = flutterDeviceId(target, opts.bootedDevice);
+    if (!device) {
+        return { launched: false, method: "flutter run", reason: `Could not resolve a flutter device id for target "${target}".` };
+    }
+    if (!(await checkToolAvailable("flutter"))) {
+        return {
+            launched: false,
+            method: "flutter run",
+            device,
+            reason: "flutter not on PATH — install the Flutter SDK to auto-launch the app, then drive with codeloop_interact.",
+        };
+    }
+    const args = ["run", "-d", device, "--no-pub", ...(opts.extraArgs ?? [])];
+    const readyTimeoutMs = opts.readyTimeoutMs ?? DEFAULT_READY_TIMEOUT_MS;
+    let child;
+    try {
+        child = spawn("flutter", args, { cwd, stdio: ["pipe", "pipe", "pipe"], detached: false });
+    }
+    catch (e) {
+        return { launched: false, method: "flutter run", device, reason: `Failed to spawn flutter run: ${e.message}` };
+    }
+    let buffer = "";
+    const onData = (d) => { buffer += d.toString(); if (buffer.length > 200_000)
+        buffer = buffer.slice(-100_000); };
+    child.stdout?.on("data", onData);
+    child.stderr?.on("data", onData);
+    const stop = async () => {
+        try {
+            // Ask `flutter run` to quit cleanly first (detaches + stops the app).
+            child.stdin?.write("q\n");
+            await new Promise((r) => setTimeout(r, 1500));
+        }
+        catch { /* ignore */ }
+        try {
+            if (child.pid && !child.killed) {
+                // Kill the whole process tree so the device-side app + tool exit.
+                if (platform() === "win32")
+                    spawn("taskkill", ["/pid", String(child.pid), "/T", "/F"]);
+                else
+                    process.kill(-child.pid, "SIGKILL");
+            }
+        }
+        catch {
+            try {
+                child.kill("SIGKILL");
+            }
+            catch { /* ignore */ }
+        }
+    };
+    // Poll the captured output for ready / failure / process-exit / timeout.
+    const deadline = Date.now() + readyTimeoutMs;
+    let exited = false;
+    child.on("exit", () => { exited = true; });
+    while (Date.now() < deadline) {
+        if (FLUTTER_READY.test(buffer)) {
+            // Give the first frame a moment to render before we screenshot/drive.
+            await new Promise((r) => setTimeout(r, 2500));
+            return { launched: true, method: `flutter run -d ${device}`, device, stop };
+        }
+        if (FLUTTER_FAILED.test(buffer) || exited) {
+            await stop();
+            return {
+                launched: false,
+                method: `flutter run -d ${device}`,
+                device,
+                reason: exited
+                    ? "flutter run exited before the app came up — the app failed to build/launch on the device."
+                    : "flutter run reported a build/launch error — the app does not start on the device.",
+                error_excerpt: buffer.split("\n").filter(Boolean).slice(-25).join("\n"),
+            };
+        }
+        await new Promise((r) => setTimeout(r, 2000));
+    }
+    // Timed out waiting for the app to come up.
+    await stop();
+    return {
+        launched: false,
+        method: `flutter run -d ${device}`,
+        device,
+        reason: `App did not finish launching within ${Math.round(readyTimeoutMs / 1000)}s (slow build or stuck on the device).`,
+        error_excerpt: buffer.split("\n").filter(Boolean).slice(-25).join("\n"),
+    };
+}
+//# sourceMappingURL=app_launcher.js.map

package/dist/runners/app_launcher.js.map

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

package/dist/runners/cli_auth.d.ts

@@ -0,0 +1,35 @@
+/**
+ * cli_auth — detect EXPIRED / MISSING provider-CLI logins and push the agent to
+ * re-authenticate so the rest of verification (backend emulators, remote logs,
+ * and the full visual journey) can proceed.
+ *
+ * When a developer's `firebase` / `gcloud` / `heroku` / … session has expired,
+ * an auto-detected backend (e.g. the Firebase Emulator Suite) can't start and
+ * remote-log pulls fail. That is NOT a code bug — it's a one-step auth fix. The
+ * right behaviour is to STOP guessing and tell the agent to run the exact login
+ * command in an interactive terminal so the USER can complete the browser
+ * sign-in, then re-run codeloop_verify and the visual journey.
+ */
+export interface CliAuthIssue {
+    /** Canonical CLI name, e.g. "firebase". */
+    cli: string;
+    /** Friendly label, e.g. "Firebase". */
+    label: string;
+    /** The exact interactive command to re-authenticate. */
+    login_command: string;
+}
+/**
+ * PURE: scan CLI/log output for expired-auth signatures and return the set of
+ * providers that need re-authentication (deduped, in table order).
+ */
+export declare function detectExpiredCliAuth(text: string): CliAuthIssue[];
+/** Look up a provider's interactive login command by CLI name. */
+export declare function loginCommandFor(cli: string): string | null;
+/**
+ * Build a HARD directive that pushes the agent to run the re-auth command(s) in
+ * an INTERACTIVE terminal so the user can complete sign-in, then re-run so the
+ * full verification (incl. visual journey) proceeds. `context` tunes the
+ * trailing instruction.
+ */
+export declare function buildCliAuthDirective(issues: CliAuthIssue[], context: "backend" | "remote-logs"): string;
+//# sourceMappingURL=cli_auth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli_auth.d.ts","sourceRoot":"","sources":["../../src/runners/cli_auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,YAAY;IAC3B,2CAA2C;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,aAAa,EAAE,MAAM,CAAC;CACvB;AAiFD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,CASjE;AAED,kEAAkE;AAClE,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG1D;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,EAAE,EACtB,OAAO,EAAE,SAAS,GAAG,aAAa,GACjC,MAAM,CAoBR"}

package/dist/runners/cli_auth.js

@@ -0,0 +1,127 @@
+/**
+ * cli_auth — detect EXPIRED / MISSING provider-CLI logins and push the agent to
+ * re-authenticate so the rest of verification (backend emulators, remote logs,
+ * and the full visual journey) can proceed.
+ *
+ * When a developer's `firebase` / `gcloud` / `heroku` / … session has expired,
+ * an auto-detected backend (e.g. the Firebase Emulator Suite) can't start and
+ * remote-log pulls fail. That is NOT a code bug — it's a one-step auth fix. The
+ * right behaviour is to STOP guessing and tell the agent to run the exact login
+ * command in an interactive terminal so the USER can complete the browser
+ * sign-in, then re-run codeloop_verify and the visual journey.
+ */
+/**
+ * Provider table. login_command is the canonical interactive re-auth command.
+ * Signatures are intentionally provider-specific so we name the right CLI.
+ */
+const PROVIDERS = [
+    {
+        cli: "firebase",
+        label: "Firebase",
+        login_command: "firebase login --reauth",
+        signatures: [
+            /firebase login --reauth/i,
+            /credentials are no longer valid/i,
+            /Failed to (?:list|retrieve) log entries.*Google Cloud/i,
+            /run `firebase login`/i,
+            /Authentication Error.*firebase/i,
+        ],
+    },
+    {
+        cli: "gcloud",
+        label: "Google Cloud (gcloud)",
+        login_command: "gcloud auth login",
+        signatures: [
+            /gcloud auth (?:login|application-default login)/i,
+            /Your current active account.*does not have any valid credentials/i,
+            /Reauthentication failed|invalid_grant/i,
+        ],
+    },
+    {
+        cli: "heroku",
+        label: "Heroku",
+        login_command: "heroku login",
+        signatures: [/heroku login/i, /not logged in.*heroku/i, /Invalid credentials.*heroku/i],
+    },
+    {
+        cli: "vercel",
+        label: "Vercel",
+        login_command: "vercel login",
+        signatures: [/vercel login/i, /not authenticated.*vercel/i, /Please log in.*vercel/i],
+    },
+    {
+        cli: "fly",
+        label: "Fly.io",
+        login_command: "fly auth login",
+        signatures: [/fly(?:ctl)? auth login/i, /not logged in.*fly/i],
+    },
+    {
+        cli: "aws",
+        label: "AWS",
+        login_command: "aws sso login   # (or: aws configure)",
+        signatures: [/aws sso login/i, /The SSO session.*has expired/i, /ExpiredToken|InvalidClientTokenId/i],
+    },
+    {
+        cli: "gh",
+        label: "GitHub CLI",
+        login_command: "gh auth login",
+        signatures: [/gh auth login/i, /authentication required.*gh/i],
+    },
+    {
+        cli: "az",
+        label: "Azure",
+        login_command: "az login",
+        signatures: [/\baz login\b/i, /az account.*not.*logged in/i, /AADSTS\d+/i],
+    },
+    {
+        cli: "supabase",
+        label: "Supabase",
+        login_command: "supabase login",
+        signatures: [/supabase login/i, /Access token not provided.*supabase/i],
+    },
+];
+/**
+ * PURE: scan CLI/log output for expired-auth signatures and return the set of
+ * providers that need re-authentication (deduped, in table order).
+ */
+export function detectExpiredCliAuth(text) {
+    if (!text)
+        return [];
+    const out = [];
+    for (const p of PROVIDERS) {
+        if (p.signatures.some((re) => re.test(text))) {
+            out.push({ cli: p.cli, label: p.label, login_command: p.login_command });
+        }
+    }
+    return out;
+}
+/** Look up a provider's interactive login command by CLI name. */
+export function loginCommandFor(cli) {
+    const p = PROVIDERS.find((x) => x.cli === cli.toLowerCase());
+    return p ? p.login_command : null;
+}
+/**
+ * Build a HARD directive that pushes the agent to run the re-auth command(s) in
+ * an INTERACTIVE terminal so the user can complete sign-in, then re-run so the
+ * full verification (incl. visual journey) proceeds. `context` tunes the
+ * trailing instruction.
+ */
+export function buildCliAuthDirective(issues, context) {
+    if (issues.length === 0)
+        return "";
+    const lines = [];
+    lines.push("[CodeLoop AUTH] A provider CLI login has EXPIRED — this is a one-step auth fix, NOT a code bug. " +
+        (context === "backend"
+            ? "Because of it, the backend (e.g. the Firebase Emulator Suite) could not start, so backend + interactive visual verification were blocked."
+            : "Because of it, production/3rd-party logs could not be pulled."));
+    lines.push("");
+    lines.push("ACTION — run the matching command in an INTERACTIVE terminal so the USER can complete the browser sign-in:");
+    for (const i of issues) {
+        lines.push(`    ${i.login_command}        # re-authenticate ${i.label}`);
+    }
+    lines.push("");
+    lines.push("Do NOT skip silently and do NOT 'fix' source code for this. After the user finishes signing in, re-run codeloop_verify; " +
+        "then call codeloop_run_journey (fix mode) so CodeLoop launches the app and runs the full visual verification.");
+    return lines.join("\n");
+}
+//# sourceMappingURL=cli_auth.js.map

package/dist/runners/cli_auth.js.map

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

package/dist/runners/journey_to_maestro.d.ts

@@ -0,0 +1,31 @@
+/**
+ * journey_to_maestro — translate a planned UserJourney into the string-step
+ * format that maestro_generator.stepToYaml understands, so codeloop_run_journey
+ * can DRIVE a real, label-based interaction suite on a booted iOS simulator /
+ * Android emulator (type into named fields, tap buttons by label, submit,
+ * assert), instead of degrading every mobile step to a manual follow-up because
+ * the coordinate-only engine has no widget targeting.
+ *
+ * Pure + unit-testable: takes a UserJourneyPlan, returns string steps. The
+ * orchestrator feeds those to generateMaestroFlow() and runs them via Maestro.
+ *
+ * Best-effort by design: Maestro matches by visible text / accessibility label,
+ * so a `tap "<label>"` only lands if that text is actually on screen. When a
+ * step can't be expressed as a label action it is simply omitted (the journey's
+ * coordinate fallback + screenshots still cover it), never invented.
+ */
+import type { UserJourneyPlan } from "../tools/plan_user_journey.js";
+export interface JourneyToMaestroOptions {
+    /** Cap how many entity arcs to include (keeps flows bounded). Default 3. */
+    maxEntities?: number;
+    /** Emit a `take screenshot` after each meaningful step. Default true. */
+    screenshots?: boolean;
+    /** Seconds to wait for an AI reply before screenshotting. Default 5. */
+    aiWaitSeconds?: number;
+}
+/**
+ * PURE: build the ordered list of Maestro string-steps for a journey plan.
+ * Order: a leading screenshot, then top entity CRUD arcs, then AI chatbox arcs.
+ */
+export declare function journeyToMaestroSteps(plan: UserJourneyPlan, opts?: JourneyToMaestroOptions): string[];
+//# sourceMappingURL=journey_to_maestro.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"journey_to_maestro.d.ts","sourceRoot":"","sources":["../../src/runners/journey_to_maestro.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,eAAe,EAAe,MAAM,+BAA+B,CAAC;AAElF,MAAM,WAAW,uBAAuB;IACtC,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AA2DD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,eAAe,EACrB,IAAI,GAAE,uBAA4B,GACjC,MAAM,EAAE,CAkCV"}