nativeapptemplate-agent 0.1.2 → 0.2.1

package/dist/mobile.js

@@ -0,0 +1,179 @@
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+import { scrubbedEnv } from "./env.js";
+const DEFAULT_COMMAND = "npx";
+// Pinned to 0.0.54 (was @latest). mobile-mcp 0.0.55+ closes the stdio
+// connection during the MCP `initialize` handshake with our pinned
+// @modelcontextprotocol/sdk — reproduced 2026-05-23: 0.0.54 connects and
+// lists tools; 0.0.55 and 0.0.56 both fail with "MCP error -32000:
+// Connection closed" before any tool call. The wrapper's tool-shape parsing
+// (envelope/prefix handling, `submit`/`device` args) is also written against
+// 0.0.54. Re-validate the handshake + tool schemas (and likely bump the SDK)
+// before moving this version forward.
+const DEFAULT_ARGS = ["-y", "@mobilenext/mobile-mcp@0.0.54"];
+// Lazy: spawns mobile-mcp on call, returns a typed client. close() shuts
+// the subprocess down cleanly.
+//
+// Honors NATIVEAPPTEMPLATE_STUB_MOBILE=1 (and NATIVEAPPTEMPLATE_STUB_ALL=1)
+// to short-circuit to a no-op client so unit tests don't need a sim or an
+// npx download.
+export async function createMobileClient(opts) {
+    if (isStubMobile())
+        return createStubMobileClient();
+    const transport = new StdioClientTransport({
+        command: opts?.command ?? DEFAULT_COMMAND,
+        args: [...(opts?.args ?? DEFAULT_ARGS)],
+        env: scrubbedEnv(),
+        stderr: "pipe",
+    });
+    const client = new Client({ name: "nativeapptemplate-agent-stage2", version: "0.1.0" });
+    await client.connect(transport);
+    return attachMobileClient(client);
+}
+// Wraps an already-connected MCP Client. Exported so tests can pair the
+// wrapper with an in-memory MCP server impersonating mobile-mcp, without
+// spawning npx. Production callers should use createMobileClient().
+export function attachMobileClient(client) {
+    return wrapClient(client);
+}
+export function isStubMobile() {
+    return (process.env["NATIVEAPPTEMPLATE_STUB_ALL"] === "1" ||
+        process.env["NATIVEAPPTEMPLATE_STUB_MOBILE"] === "1");
+}
+// Tools that operate at the mobile-mcp server level rather than against
+// a specific device. These don't take a `device` argument and would
+// fail validation if we injected one.
+const DEVICE_INDEPENDENT_TOOLS = new Set([
+    "mobile_list_available_devices",
+]);
+function wrapClient(client) {
+    let activeDevice;
+    const callTool = async (name, args) => {
+        const merged = activeDevice !== undefined && !DEVICE_INDEPENDENT_TOOLS.has(name)
+            ? { device: activeDevice, ...(args ?? {}) }
+            : (args ?? {});
+        const result = (await client.callTool({
+            name,
+            arguments: merged,
+        }));
+        if (result.isError) {
+            throw new Error(`mobile-mcp ${name} failed: ${textOf(result)}`);
+        }
+        return result;
+    };
+    return {
+        callTool,
+        useDevice(name) {
+            activeDevice = name;
+        },
+        async listDevices() {
+            const result = await callTool("mobile_list_available_devices");
+            // mobile-mcp 0.0.54+ returns {"devices": [...]} (envelope object,
+            // not a bare array). Earlier behavior was a bare array. Accept
+            // either so the wrapper survives version drift in either direction.
+            const text = textOf(result);
+            if (!text)
+                return [];
+            try {
+                const parsed = JSON.parse(text);
+                if (Array.isArray(parsed))
+                    return parsed;
+                if (parsed && typeof parsed === "object" && Array.isArray(parsed.devices)) {
+                    return parsed.devices;
+                }
+                return [];
+            }
+            catch {
+                return [];
+            }
+        },
+        async listElements() {
+            const result = await callTool("mobile_list_elements_on_screen");
+            // mobile-mcp 0.0.54 returns "Found these elements on screen: [...]"
+            // — a human-readable text prefix followed by a JSON array, not
+            // pure JSON. Slice from the first '[' so JSON.parse sees just
+            // the array. Defensive against the prefix being absent in other
+            // versions too.
+            const text = textOf(result);
+            if (!text)
+                return [];
+            const arrayStart = text.indexOf("[");
+            if (arrayStart === -1)
+                return [];
+            try {
+                const parsed = JSON.parse(text.slice(arrayStart));
+                return Array.isArray(parsed) ? parsed : [];
+            }
+            catch {
+                return [];
+            }
+        },
+        async click(x, y) {
+            // mobile-mcp 0.0.54's iOS backend (mobilecli `io tap`) rejects
+            // non-integer coordinates. centerOf often produces .5 values for
+            // even-width elements; floor them at the tool boundary so callers
+            // don't have to think about it.
+            await callTool("mobile_click_on_screen_at_coordinates", {
+                x: Math.floor(x),
+                y: Math.floor(y),
+            });
+        },
+        async typeKeys(text, submit = false) {
+            // mobile-mcp 0.0.54 requires `submit: boolean` — passing only
+            // {text} fails Zod validation with "expected boolean, received
+            // undefined". Default false; opt in to true via the second
+            // arg when the caller wants the keyboard's return/submit key
+            // tapped after typing (form-submit / keyboard-dismiss).
+            await callTool("mobile_type_keys", { text, submit });
+        },
+        async pressButton(button) {
+            await callTool("mobile_press_button", { button });
+        },
+        async launchApp(packageName) {
+            // mobile-mcp uses `packageName` for the app id on both platforms (the
+            // bundle id on iOS). `device` is injected by callTool.
+            await callTool("mobile_launch_app", { packageName });
+        },
+        async takeScreenshot() {
+            const result = await callTool("mobile_take_screenshot");
+            const image = (result.content ?? []).find((c) => c.type === "image");
+            if (!image || typeof image.data !== "string") {
+                throw new Error("mobile-mcp mobile_take_screenshot returned no image data");
+            }
+            return {
+                data: Buffer.from(image.data, "base64"),
+                mimeType: typeof image.mimeType === "string" ? image.mimeType : "image/png",
+            };
+        },
+        async saveScreenshot(absolutePath) {
+            await callTool("mobile_save_screenshot", { saveTo: absolutePath });
+        },
+        async close() {
+            await client.close();
+        },
+    };
+}
+function textOf(result) {
+    for (const c of result.content ?? []) {
+        if (c.type === "text" && typeof c.text === "string")
+            return c.text;
+    }
+    return "";
+}
+function createStubMobileClient() {
+    const stubResult = { content: [] };
+    return {
+        callTool: async () => stubResult,
+        useDevice: () => { },
+        listDevices: async () => [],
+        listElements: async () => [],
+        click: async () => { },
+        typeKeys: async (_text, _submit) => { },
+        pressButton: async () => { },
+        launchApp: async (_packageName) => { },
+        takeScreenshot: async () => ({ data: Buffer.alloc(0), mimeType: "image/png" }),
+        saveScreenshot: async () => { },
+        close: async () => { },
+    };
+}
+//# sourceMappingURL=mobile.js.map

package/dist/mobile.js.map

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

package/dist/rails-lifecycle.d.ts

@@ -0,0 +1,16 @@
+import { type ChildProcess } from "node:child_process";
+export type RailsHandle = {
+    readonly child: ChildProcess;
+    readonly url: string;
+    stop(): Promise<void>;
+};
+export type StartRailsInput = {
+    outDir: string;
+    host?: string;
+    port?: number;
+    readyTimeoutMs?: number;
+    shutdownGraceMs?: number;
+};
+export declare function startRails(input: StartRailsInput): Promise<RailsHandle>;
+export declare function waitForReady(host: string, port: number, timeoutMs: number, childExitedEarly?: () => boolean): Promise<boolean>;
+//# sourceMappingURL=rails-lifecycle.d.ts.map

package/dist/rails-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rails-lifecycle.d.ts","sourceRoot":"","sources":["../src/rails-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAoB9D,MAAM,MAAM,WAAW,GAAG;IAGxB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAC;IAIf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IAId,cAAc,CAAC,EAAE,MAAM,CAAC;IAGxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAKF,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC,CAkG7E;AAED,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,gBAAgB,CAAC,EAAE,MAAM,OAAO,GAC/B,OAAO,CAAC,OAAO,CAAC,CAgBlB"}

package/dist/rails-lifecycle.js

@@ -0,0 +1,184 @@
+import { spawn } from "node:child_process";
+import { setTimeout as sleep } from "node:timers/promises";
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { scrubbedEnv } from "./env.js";
+import { trace } from "./trace.js";
+const DEFAULT_READY_TIMEOUT_MS = 60_000;
+const DEFAULT_SHUTDOWN_GRACE_MS = 5_000;
+export async function startRails(input) {
+    const { host, port } = await resolveHostPort(input);
+    const url = `http://${host}:${port}`;
+    // Two prep steps before bin/dev:
+    //   1. bundle install — Layer 2 ran it but gems land in a path
+    //      bin/rails sees for one-shot CLI; bin/dev needs them again
+    //      in the same shell context. Idempotent + fast (~1s warm).
+    //   2. bin/rails db:prepare — creates+migrates the primary db AND
+    //      the cable/queue/cache databases the substrate uses
+    //      (config/database.yml multi-db). Without it, Solid Queue
+    //      (loaded as a Puma plugin via SOLID_QUEUE_IN_PUMA=true in
+    //      .env) can't open its queue connection and crashes Puma:
+    //      "Detected Solid Queue has gone away, stopping Puma".
+    trace("dispatch", `rails-lifecycle: bundle install in ${input.outDir}`);
+    await runMiseStep(input.outDir, ["bundle", "install"], 180_000, "bundle install");
+    trace("dispatch", `rails-lifecycle: bin/rails db:prepare in ${input.outDir}`);
+    await runMiseStep(input.outDir, ["bin/rails", "db:prepare"], 60_000, "db:prepare");
+    // db:seed_fu — substrate uses the seed-fu gem (NOT standard
+    // db:seed). Required because db:prepare only runs seeds on
+    // fresh-create; for an already-existing DB it just migrates,
+    // leaving PrivacyVersion / TermsVersion empty — which causes
+    // signup to 500 in render_create_success when it looks up the
+    // current version. seed-fu is idempotent.
+    trace("dispatch", `rails-lifecycle: bin/rails db:seed_fu in ${input.outDir}`);
+    await runMiseStep(input.outDir, ["bin/rails", "db:seed_fu"], 60_000, "db:seed_fu");
+    // Wrap with `mise exec --` so the substrate's pinned Ruby /
+    // bundler version activates (substrate's .mise.toml or .tool-versions
+    // pins a specific version that may not match system Ruby). Layer 2
+    // uses the same wrapper for `bin/rails runner` — match it here so
+    // Stage 2's server uses the same toolchain that Layer 2 validated.
+    trace("dispatch", `rails-lifecycle: spawning mise exec -- bin/dev in ${input.outDir} (target ${url})`);
+    const child = spawn("mise", ["exec", "--", "bin/dev"], {
+        cwd: input.outDir,
+        env: scrubbedEnv(),
+        stdio: ["ignore", "pipe", "pipe"],
+        detached: false,
+    });
+    // Drain stdio so the child doesn't block on backed-up pipes; route
+    // a tail to the dispatch trace so silent failures (port already in
+    // use, missing gem, etc.) surface in tmp/trace/dispatch.log.
+    const tail = [];
+    const onData = (c) => {
+        const text = c.toString("utf8");
+        tail.push(text);
+        if (tail.length > 50)
+            tail.shift();
+    };
+    child.stdout?.on("data", onData);
+    child.stderr?.on("data", onData);
+    // Surface child crash before we time out waiting for ready.
+    let exitedEarly = false;
+    child.on("exit", (code) => {
+        exitedEarly = true;
+        trace("dispatch", `rails-lifecycle: child exited early (code=${code}); recent output: ${tail.join("").slice(-500)}`);
+    });
+    const readyTimeoutMs = input.readyTimeoutMs ?? DEFAULT_READY_TIMEOUT_MS;
+    const ready = await waitForReady(host, port, readyTimeoutMs, () => exitedEarly);
+    if (!ready) {
+        child.kill("SIGTERM");
+        const lastOutput = tail.join("").slice(-500);
+        throw new Error(`Rails server at ${url} did not become ready within ${readyTimeoutMs}ms` +
+            (exitedEarly ? ` (child exited early)` : "") +
+            `; recent output: ${lastOutput}`);
+    }
+    trace("dispatch", `rails-lifecycle: server reachable at ${url}`);
+    const shutdownGraceMs = input.shutdownGraceMs ?? DEFAULT_SHUTDOWN_GRACE_MS;
+    return {
+        child,
+        url,
+        async stop() {
+            if (exitedEarly)
+                return;
+            trace("dispatch", `rails-lifecycle: stopping ${url}`);
+            child.kill("SIGTERM");
+            const exit = new Promise((resolve) => {
+                if (child.exitCode !== null) {
+                    resolve();
+                }
+                else {
+                    child.on("exit", () => resolve());
+                }
+            });
+            const timeout = sleep(shutdownGraceMs).then(() => {
+                if (child.exitCode === null) {
+                    trace("dispatch", `rails-lifecycle: SIGTERM did not exit in ${shutdownGraceMs}ms; SIGKILL`);
+                    child.kill("SIGKILL");
+                }
+            });
+            await Promise.race([exit, timeout]);
+        },
+    };
+}
+export async function waitForReady(host, port, timeoutMs, childExitedEarly) {
+    const url = `http://${host}:${port}/`;
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        if (childExitedEarly?.())
+            return false;
+        try {
+            const res = await fetch(url, { signal: AbortSignal.timeout(2_000) });
+            // Any HTTP response (even 404) means Rails is up. Network/connection
+            // errors throw; we keep polling.
+            if (res.status < 500)
+                return true;
+        }
+        catch {
+            // ECONNREFUSED, EHOSTUNREACH, AbortError — not ready, keep polling.
+        }
+        await sleep(1_000);
+    }
+    return false;
+}
+async function resolveHostPort(input) {
+    if (input.host !== undefined && input.port !== undefined) {
+        return { host: input.host, port: input.port };
+    }
+    // Read from the generated rails dir's .env (which mirrors substrate's
+    // .env via the rails worker's verbatim copy).
+    const envPath = join(input.outDir, ".env");
+    const env = await readDotenv(envPath);
+    const host = input.host ?? env["HOST"] ?? "0.0.0.0";
+    const portStr = env["PORT"];
+    const port = input.port ?? (portStr ? Number.parseInt(portStr, 10) : 3000);
+    if (Number.isNaN(port))
+        throw new Error(`rails-lifecycle: PORT in ${envPath} is not a number: ${portStr}`);
+    return { host, port };
+}
+async function runMiseStep(cwd, args, timeoutMs, label) {
+    await new Promise((resolveStep, rejectStep) => {
+        const child = spawn("mise", ["exec", "--", ...args], {
+            cwd,
+            env: scrubbedEnv(),
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        const out = [];
+        child.stdout?.on("data", (c) => out.push(c.toString("utf8")));
+        child.stderr?.on("data", (c) => out.push(c.toString("utf8")));
+        const timer = setTimeout(() => child.kill("SIGTERM"), timeoutMs);
+        child.on("exit", (code) => {
+            clearTimeout(timer);
+            if (code === 0)
+                resolveStep();
+            else
+                rejectStep(new Error(`${label} exited ${code}: ${out.join("").slice(-800)}`));
+        });
+        child.on("error", (err) => {
+            clearTimeout(timer);
+            rejectStep(err);
+        });
+    });
+}
+async function readDotenv(path) {
+    let raw;
+    try {
+        raw = await readFile(path, "utf8");
+    }
+    catch {
+        return {};
+    }
+    const out = {};
+    for (const line of raw.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        const eq = trimmed.indexOf("=");
+        if (eq < 1)
+            continue;
+        const key = trimmed.slice(0, eq).trim();
+        const valueRaw = trimmed.slice(eq + 1).trim();
+        const value = valueRaw.replace(/^"(.*)"$/, "$1").replace(/^'(.*)'$/, "$1");
+        if (key && value)
+            out[key] = value;
+    }
+    return out;
+}
+//# sourceMappingURL=rails-lifecycle.js.map

package/dist/rails-lifecycle.js.map

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

package/dist/rename-overrides.d.ts

@@ -0,0 +1,23 @@
+import type { Entity, RenamePair } from "./agents/types.js";
+export type OverrideOutcome = {
+    kind: "changed";
+    from: string;
+    was: string;
+    to: string;
+} | {
+    kind: "noop";
+    from: string;
+    to: string;
+} | {
+    kind: "unmatched";
+    from: string;
+    to: string;
+};
+export type ApplyOverridesResult = {
+    plan: RenamePair[];
+    outcomes: OverrideOutcome[];
+};
+export declare function parseRenamePair(raw: string | undefined): RenamePair | null;
+export declare function applyRenameOverrides(plan: readonly RenamePair[], overrides: readonly RenamePair[]): ApplyOverridesResult;
+export declare function syncEntityNames(entities: readonly Entity[], outcomes: readonly OverrideOutcome[]): readonly Entity[];
+//# sourceMappingURL=rename-overrides.d.ts.map

package/dist/rename-overrides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rename-overrides.d.ts","sourceRoot":"","sources":["../src/rename-overrides.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAO5D,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpD,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B,CAAC;AAKF,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,IAAI,CAQ1E;AAOD,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,SAAS,UAAU,EAAE,EAC3B,SAAS,EAAE,SAAS,UAAU,EAAE,GAC/B,oBAAoB,CAiBtB;AAQD,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,QAAQ,EAAE,SAAS,eAAe,EAAE,GACnC,SAAS,MAAM,EAAE,CAUnB"}

package/dist/rename-overrides.js

@@ -0,0 +1,58 @@
+// Parse a single `--rename From=To` value. Splits on the first `=` only;
+// returns null for malformed input (missing flag value, empty side) so the
+// caller can warn and skip rather than push a junk pair into the plan.
+export function parseRenamePair(raw) {
+    if (raw === undefined)
+        return null;
+    const eq = raw.indexOf("=");
+    if (eq <= 0)
+        return null;
+    const from = raw.slice(0, eq).trim();
+    const to = raw.slice(eq + 1).trim();
+    if (!from || !to)
+        return null;
+    return { from, to };
+}
+// Merge manual overrides onto the planner's rename plan. Semantics are
+// "change a planned target": an override keys on the substrate token (`from`)
+// and replaces the planner's chosen target (`to`). Overrides whose `from`
+// matches no planned rename are reported as `unmatched` and dropped — we don't
+// silently invent new renames. Later overrides for the same `from` win.
+export function applyRenameOverrides(plan, overrides) {
+    const merged = plan.map((p) => ({ ...p }));
+    const outcomes = [];
+    for (const override of overrides) {
+        const target = merged.find((p) => p.from === override.from);
+        if (!target) {
+            outcomes.push({ kind: "unmatched", from: override.from, to: override.to });
+            continue;
+        }
+        if (target.to === override.to) {
+            outcomes.push({ kind: "noop", from: override.from, to: override.to });
+            continue;
+        }
+        outcomes.push({ kind: "changed", from: override.from, was: target.to, to: override.to });
+        target.to = override.to;
+    }
+    return { plan: merged, outcomes };
+}
+// Keep entity names in step with rename-plan overrides. The planner names each
+// entity after its rename target (e.g. it emits both `Shopkeeper -> Monitor`
+// and an entity `Monitor` that `replaces` Shopkeeper), so a `--rename` that
+// changes the target must also rename the entity or the report contradicts its
+// own rename plan. Only entities whose name still matches the planner's old
+// target are touched — an entity deliberately named differently is left alone.
+export function syncEntityNames(entities, outcomes) {
+    const changes = new Map();
+    for (const o of outcomes) {
+        if (o.kind === "changed")
+            changes.set(o.from, { was: o.was, to: o.to });
+    }
+    if (changes.size === 0)
+        return entities;
+    return entities.map((e) => {
+        const change = changes.get(e.replaces);
+        return change && e.name === change.was ? { ...e, name: change.to } : e;
+    });
+}
+//# sourceMappingURL=rename-overrides.js.map

package/dist/rename-overrides.js.map

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

package/dist/repair-loop.d.ts

@@ -0,0 +1,25 @@
+import type { Platform, PlatformDetail } from "./agents/types.js";
+import type { RepairAttempt } from "./report/model.js";
+import type { RepairLayer } from "./agents/repair.js";
+export type RevalidateResult = Pick<PlatformDetail, "layer1" | "layer2">;
+export type RepairLoopDeps = {
+    repair: (platform: Platform, layer: RepairLayer, detail: PlatformDetail) => Promise<{
+        action: string;
+    }>;
+    revalidate: (platform: Platform) => Promise<RevalidateResult>;
+};
+export type RepairLoopInput = {
+    platforms: readonly PlatformDetail[];
+    reviewerPass: boolean;
+    maxIterations: number;
+    deps: RepairLoopDeps;
+};
+export type RepairLoopResult = {
+    platforms: PlatformDetail[];
+    attempts: RepairAttempt[];
+    overallPass: boolean;
+    summary: string;
+};
+export declare const REPAIR_ITERATION_CAP = 5;
+export declare function runRepairLoop(input: RepairLoopInput): Promise<RepairLoopResult>;
+//# sourceMappingURL=repair-loop.d.ts.map

package/dist/repair-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair-loop.d.ts","sourceRoot":"","sources":["../src/repair-loop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAKtD,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,QAAQ,CAAC,CAAC;AAEzE,MAAM,MAAM,cAAc,GAAG;IAG3B,MAAM,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAExG,UAAU,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC/D,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,SAAS,cAAc,EAAE,CAAC;IACrC,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,cAAc,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAMF,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAYtC,wBAAsB,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA4BrF"}

package/dist/repair-loop.js

@@ -0,0 +1,67 @@
+// The CLAUDE.md hard cap: never iterate more than this regardless of the
+// requested maxIterations.
+export const REPAIR_ITERATION_CAP = 5;
+// Bounded self-repair: while a code-repairable layer is failing, repair the
+// highest-priority failure, re-validate that platform, and record the
+// attempt — until everything passes or the iteration cap is hit. Pure
+// control flow: all I/O (the repair agent, the validators) is injected via
+// deps, so this is unit-testable without the LLM or a device.
+//
+// Scope: Layer 1 (leftover tokens) then Layer 2 (build) are the
+// code-repairable, cheaply re-checkable layers. Layer 3 (vision) and the
+// contract reviewer are surfaced but not auto-repaired — a Layer 3 miss is
+// often environmental (e.g. a first-launch system dialog), not a source bug.
+export async function runRepairLoop(input) {
+    const cap = Math.min(input.maxIterations, REPAIR_ITERATION_CAP);
+    const platforms = input.platforms.map((p) => ({ ...p }));
+    const attempts = [];
+    for (let iteration = 1; iteration <= cap; iteration++) {
+        const target = nextTarget(platforms);
+        if (!target)
+            break; // no code-repairable failure remains
+        const detail = platforms.find((p) => p.platform === target.platform);
+        const { action } = await input.deps.repair(target.platform, target.layer, detail);
+        const revalidated = await input.deps.revalidate(target.platform);
+        const idx = platforms.findIndex((p) => p.platform === target.platform);
+        platforms[idx] = { ...platforms[idx], layer1: revalidated.layer1, layer2: revalidated.layer2 };
+        const resolved = target.layer === "layer1" ? revalidated.layer1.pass : revalidated.layer2.pass;
+        attempts.push({ iteration, failingLayer: target.layer, platform: target.platform, action, resolved });
+        if (computeOverall(platforms, input.reviewerPass))
+            break;
+    }
+    return {
+        platforms,
+        attempts,
+        overallPass: computeOverall(platforms, input.reviewerPass),
+        summary: summarize(platforms, input.reviewerPass),
+    };
+}
+// Highest-priority code-repairable failure: all Layer 1 misses before any
+// Layer 2 miss (leftover tokens routinely cause the build error, so fixing
+// structure first avoids chasing a downstream symptom).
+function nextTarget(platforms) {
+    for (const p of platforms)
+        if (!p.layer1.pass)
+            return { platform: p.platform, layer: "layer1" };
+    for (const p of platforms)
+        if (!p.layer2.pass)
+            return { platform: p.platform, layer: "layer2" };
+    return undefined;
+}
+function computeOverall(platforms, reviewerPass) {
+    const layer1And2 = platforms.every((p) => p.layer1.pass && p.layer2.pass);
+    const layer3 = platforms.every((p) => p.layer3 === undefined || p.layer3.pass);
+    return layer1And2 && layer3 && reviewerPass;
+}
+// Mirrors the judge's one-line summary so the post-repair report reads
+// identically to a first-pass report.
+function summarize(platforms, reviewerPass) {
+    const total = platforms.length;
+    const l1 = platforms.filter((p) => p.layer1.pass).length;
+    const l2 = platforms.filter((p) => p.layer2.pass).length;
+    const l3Plats = platforms.filter((p) => p.layer3 !== undefined);
+    const l3 = l3Plats.filter((p) => p.layer3.pass).length;
+    const l3Summary = l3Plats.length > 0 ? `Layer 3 ${l3}/${l3Plats.length} pass` : "Layer 3 skipped";
+    return `Layer 1 ${l1}/${total} pass · Layer 2 ${l2}/${total} pass · ${l3Summary} · reviewer ${reviewerPass ? "PASS" : "FAIL"}`;
+}
+//# sourceMappingURL=repair-loop.js.map

package/dist/repair-loop.js.map

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

package/dist/report/collect.d.ts

@@ -0,0 +1,28 @@
+import type { DomainSpec, JudgeResult, ReviewerResult } from "../agents/types.js";
+import type { RepairAttempt, RunReport } from "./model.js";
+export type ReportFormat = "html" | "json" | "both";
+export type BuildRunReportInput = {
+    spec: string;
+    domain: DomainSpec;
+    judge: JudgeResult;
+    reviewer: ReviewerResult;
+    agentVersion: string;
+    judgeModel: string;
+    visualLevel: 0 | 1 | 2;
+    startedAt: number;
+    finishedAt: number;
+    repairAttempts?: readonly RepairAttempt[];
+};
+export declare function buildRunReport(input: BuildRunReportInput): RunReport;
+export type WriteReportOptions = {
+    dir: string;
+    format?: ReportFormat;
+    embed?: boolean;
+};
+export type ReportPaths = {
+    jsonPath?: string;
+    htmlPath?: string;
+};
+export declare function writeReport(report: RunReport, options: WriteReportOptions): Promise<ReportPaths>;
+export declare function collectScreenshotPaths(report: RunReport): string[];
+//# sourceMappingURL=collect.d.ts.map

package/dist/report/collect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect.d.ts","sourceRoot":"","sources":["../../src/report/collect.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAElF,OAAO,KAAK,EAAY,aAAa,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAErE,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAEpD,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,cAAc,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;CAC3C,CAAC;AAIF,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,SAAS,CAqCpE;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,wBAAsB,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,CAqBtG;AAID,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,EAAE,CAgBlE"}