nativeapptemplate-agent 0.1.0

package/dist/slug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.js","sourceRoot":"","sources":["../src/slug.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI;SACR,KAAK,CAAC,MAAM,CAAC;SACb,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAClD,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACjC,CAAC"}

package/dist/stub.d.ts

@@ -0,0 +1,3 @@
+import type { AgentName } from "./agents/types.js";
+export declare function isStub(agent: AgentName): boolean;
+//# sourceMappingURL=stub.d.ts.map

package/dist/stub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub.d.ts","sourceRoot":"","sources":["../src/stub.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAGhD"}

package/dist/stub.js

@@ -0,0 +1,6 @@
+export function isStub(agent) {
+    if (process.env['NATIVEAPPTEMPLATE_STUB_ALL'] === "1")
+        return true;
+    return process.env[`NATIVEAPPTEMPLATE_STUB_${agent.toUpperCase()}`] === "1";
+}
+//# sourceMappingURL=stub.js.map

package/dist/stub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub.js","sourceRoot":"","sources":["../src/stub.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,MAAM,CAAC,KAAgB;IACrC,IAAI,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACnE,OAAO,OAAO,CAAC,GAAG,CAAC,0BAA0B,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC;AAC9E,CAAC"}

package/dist/trace.d.ts

@@ -0,0 +1,3 @@
+import type { AgentName } from "./agents/types.js";
+export declare function trace(agent: AgentName, text: string): void;
+//# sourceMappingURL=trace.d.ts.map

package/dist/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAKnD,wBAAgB,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAO1D"}

package/dist/trace.js

@@ -0,0 +1,13 @@
+import { appendFileSync, mkdirSync } from "node:fs";
+import { resolve } from "node:path";
+const traceDir = resolve(process.cwd(), "tmp/trace");
+let dirEnsured = false;
+export function trace(agent, text) {
+    if (!dirEnsured) {
+        mkdirSync(traceDir, { recursive: true });
+        dirEnsured = true;
+    }
+    const ts = new Date().toISOString().slice(11, 19);
+    appendFileSync(resolve(traceDir, `${agent}.log`), `[${ts}] ${text}\n`);
+}
+//# sourceMappingURL=trace.js.map

package/dist/trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,CAAC,CAAC;AACrD,IAAI,UAAU,GAAG,KAAK,CAAC;AAEvB,MAAM,UAAU,KAAK,CAAC,KAAgB,EAAE,IAAY;IAClD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,UAAU,GAAG,IAAI,CAAC;IACpB,CAAC;IACD,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAClD,cAAc,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,KAAK,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC,CAAC;AACzE,CAAC"}

package/dist/validation/capture.d.ts

@@ -0,0 +1,15 @@
+export type CapturePlatform = "ios" | "android";
+export type CaptureResult = {
+    ok: boolean;
+    path: string;
+    command: string;
+    durationMs: number;
+    error?: string;
+};
+export type CaptureInput = {
+    platform: CapturePlatform;
+    outPath: string;
+    timeoutMs?: number;
+};
+export declare function captureScreenshot(input: CaptureInput): Promise<CaptureResult>;
+//# sourceMappingURL=capture.d.ts.map

package/dist/validation/capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/validation/capture.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,SAAS,CAAC;AAEhD,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAaF,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAUnF"}

package/dist/validation/capture.js

@@ -0,0 +1,141 @@
+import { spawn } from "node:child_process";
+import { createWriteStream } from "node:fs";
+import { mkdir } from "node:fs/promises";
+import { dirname } from "node:path";
+import { scrubbedEnv } from "../env.js";
+import { resolveAdbPath } from "../adb.js";
+const DEFAULT_TIMEOUT_MS = 15_000;
+// Capture the home screen of whatever's currently booted on the iOS Simulator
+// or Android emulator. The agent does NOT boot the sim/emulator itself —
+// that's a developer-environment concern (per memory: user runs Android Studio
+// Device Manager for AVDs; iOS Simulator started via Xcode). This function
+// assumes one is already running and the target app is on its home screen.
+//
+// Install + launch + screen-readiness polling are separate concerns; they'll
+// land in follow-up PRs that wire post-Layer-2-build → install → launch →
+// captureScreenshot → runLayer3 together.
+export async function captureScreenshot(input) {
+    const timeoutMs = input.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    await mkdir(dirname(input.outPath), { recursive: true });
+    switch (input.platform) {
+        case "ios":
+            return captureIos(input.outPath, timeoutMs);
+        case "android":
+            return captureAndroid(input.outPath, timeoutMs);
+    }
+}
+async function captureIos(outPath, timeoutMs) {
+    const command = `xcrun simctl io booted screenshot ${outPath}`;
+    const started = Date.now();
+    return new Promise((resolvePromise) => {
+        let child;
+        try {
+            child = spawn("xcrun", ["simctl", "io", "booted", "screenshot", outPath], {
+                env: scrubbedEnv(),
+                stdio: ["ignore", "pipe", "pipe"],
+            });
+        }
+        catch (err) {
+            resolvePromise({
+                ok: false,
+                path: outPath,
+                command,
+                durationMs: Date.now() - started,
+                error: err instanceof Error ? err.message : String(err),
+            });
+            return;
+        }
+        const stderrChunks = [];
+        child.stderr.on("data", (c) => stderrChunks.push(c));
+        const timer = setTimeout(() => { child.kill("SIGTERM"); }, timeoutMs);
+        child.on("close", (code) => {
+            clearTimeout(timer);
+            const durationMs = Date.now() - started;
+            const stderr = Buffer.concat(stderrChunks).toString("utf8").trim();
+            if (code === 0) {
+                resolvePromise({ ok: true, path: outPath, command, durationMs });
+            }
+            else {
+                resolvePromise({
+                    ok: false,
+                    path: outPath,
+                    command,
+                    durationMs,
+                    error: stderr || `xcrun simctl exited ${code}`,
+                });
+            }
+        });
+        child.on("error", (err) => {
+            clearTimeout(timer);
+            resolvePromise({
+                ok: false,
+                path: outPath,
+                command,
+                durationMs: Date.now() - started,
+                error: err.message,
+            });
+        });
+    });
+}
+async function captureAndroid(outPath, timeoutMs) {
+    const adb = resolveAdbPath();
+    const command = `${adb} exec-out screencap -p > ${outPath}`;
+    const started = Date.now();
+    return new Promise((resolvePromise) => {
+        let child;
+        try {
+            child = spawn(adb, ["exec-out", "screencap", "-p"], {
+                env: scrubbedEnv(),
+                stdio: ["ignore", "pipe", "pipe"],
+            });
+        }
+        catch (err) {
+            resolvePromise({
+                ok: false,
+                path: outPath,
+                command,
+                durationMs: Date.now() - started,
+                error: err instanceof Error ? err.message : String(err),
+            });
+            return;
+        }
+        const out = createWriteStream(outPath);
+        let pipeError = null;
+        out.on("error", (err) => { pipeError = err; });
+        child.stdout.pipe(out);
+        const stderrChunks = [];
+        child.stderr.on("data", (c) => stderrChunks.push(c));
+        const timer = setTimeout(() => { child.kill("SIGTERM"); }, timeoutMs);
+        child.on("close", (code) => {
+            clearTimeout(timer);
+            out.end(() => {
+                const durationMs = Date.now() - started;
+                const stderr = Buffer.concat(stderrChunks).toString("utf8").trim();
+                if (code === 0 && !pipeError) {
+                    resolvePromise({ ok: true, path: outPath, command, durationMs });
+                }
+                else {
+                    resolvePromise({
+                        ok: false,
+                        path: outPath,
+                        command,
+                        durationMs,
+                        error: pipeError?.message ?? stderr ?? `adb exited ${code}`,
+                    });
+                }
+            });
+        });
+        child.on("error", (err) => {
+            clearTimeout(timer);
+            out.end();
+            resolvePromise({
+                ok: false,
+                path: outPath,
+                command,
+                durationMs: Date.now() - started,
+                error: err.message,
+            });
+        });
+    });
+}
+//# sourceMappingURL=capture.js.map

package/dist/validation/capture.js.map

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

package/dist/validation/discover.d.ts

@@ -0,0 +1,11 @@
+export type IosArtifact = {
+    appPath: string;
+    bundleId: string;
+};
+export type AndroidArtifact = {
+    apkPath: string;
+    packageName: string;
+};
+export declare function discoverIosArtifact(iosDir: string): Promise<IosArtifact | null>;
+export declare function discoverAndroidArtifact(androidDir: string): Promise<AndroidArtifact | null>;
+//# sourceMappingURL=discover.d.ts.map

package/dist/validation/discover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../src/validation/discover.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,WAAW,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAChE,MAAM,MAAM,eAAe,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AAWvE,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAoBrF;AAKD,wBAAsB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAgBjG"}

package/dist/validation/discover.js

@@ -0,0 +1,113 @@
+import { spawn } from "node:child_process";
+import { readFile, readdir, stat } from "node:fs/promises";
+import { join } from "node:path";
+import { scrubbedEnv } from "../env.js";
+// Matches Layer 2 build mode's IOS_DESTINATION so showBuildSettings sees the
+// same SDK/configuration that `xcodebuild build` produced.
+const IOS_DESTINATION = "platform=iOS Simulator,name=iPhone 17,OS=26.2";
+// After Layer 2 build mode has built the iOS .app, ask xcodebuild where it
+// landed and read the bundle identifier from the built Info.plist (so any
+// $(VAR) interpolations are already resolved). Returns null if the build
+// hasn't happened, the project layout doesn't match expectations, or the
+// build settings query fails.
+export async function discoverIosArtifact(iosDir) {
+    const entries = await readdir(iosDir).catch(() => []);
+    const xcodeproj = entries.find((e) => e.endsWith(".xcodeproj"));
+    if (!xcodeproj)
+        return null;
+    const scheme = xcodeproj.replace(/\.xcodeproj$/, "");
+    const settings = await runShowBuildSettings(iosDir, xcodeproj, scheme);
+    if (!settings)
+        return null;
+    const builtProductsDir = settings["BUILT_PRODUCTS_DIR"];
+    const wrapperName = settings["WRAPPER_NAME"];
+    if (!builtProductsDir || !wrapperName)
+        return null;
+    const appPath = join(builtProductsDir, wrapperName);
+    const appExists = await stat(appPath).then(() => true).catch(() => false);
+    if (!appExists)
+        return null;
+    const bundleId = await readBundleId(join(appPath, "Info.plist"));
+    if (!bundleId)
+        return null;
+    return { appPath, bundleId };
+}
+// Android `applicationId` lives in `app/build.gradle.kts`; the APK path is
+// predictable. Returns null if the build hasn't happened or the gradle file
+// doesn't have an `applicationId = "..."` line.
+export async function discoverAndroidArtifact(androidDir) {
+    const apkPath = join(androidDir, "app", "build", "outputs", "apk", "debug", "app-debug.apk");
+    const apkExists = await stat(apkPath).then(() => true).catch(() => false);
+    if (!apkExists)
+        return null;
+    const gradlePath = join(androidDir, "app", "build.gradle.kts");
+    let gradle;
+    try {
+        gradle = await readFile(gradlePath, "utf8");
+    }
+    catch {
+        return null;
+    }
+    const match = gradle.match(/applicationId\s*=\s*"([^"]+)"/);
+    if (!match || !match[1])
+        return null;
+    return { apkPath, packageName: match[1] };
+}
+async function runShowBuildSettings(cwd, xcodeproj, scheme) {
+    return new Promise((resolvePromise) => {
+        let child;
+        try {
+            child = spawn("xcodebuild", [
+                "-project", xcodeproj,
+                "-scheme", scheme,
+                "-destination", IOS_DESTINATION,
+                "-showBuildSettings",
+                "-json",
+            ], { cwd, env: scrubbedEnv(), stdio: ["ignore", "pipe", "pipe"] });
+        }
+        catch {
+            resolvePromise(null);
+            return;
+        }
+        const stdoutChunks = [];
+        child.stdout.on("data", (c) => stdoutChunks.push(c));
+        child.on("close", (code) => {
+            if (code !== 0) {
+                resolvePromise(null);
+                return;
+            }
+            try {
+                const arr = JSON.parse(Buffer.concat(stdoutChunks).toString("utf8"));
+                resolvePromise(arr[0]?.buildSettings ?? null);
+            }
+            catch {
+                resolvePromise(null);
+            }
+        });
+        child.on("error", () => resolvePromise(null));
+    });
+}
+async function readBundleId(infoPlistPath) {
+    return new Promise((resolvePromise) => {
+        let child;
+        try {
+            child = spawn("plutil", ["-extract", "CFBundleIdentifier", "raw", "-o", "-", infoPlistPath], { env: scrubbedEnv(), stdio: ["ignore", "pipe", "pipe"] });
+        }
+        catch {
+            resolvePromise(null);
+            return;
+        }
+        const stdoutChunks = [];
+        child.stdout.on("data", (c) => stdoutChunks.push(c));
+        child.on("close", (code) => {
+            if (code !== 0) {
+                resolvePromise(null);
+                return;
+            }
+            const out = Buffer.concat(stdoutChunks).toString("utf8").trim();
+            resolvePromise(out || null);
+        });
+        child.on("error", () => resolvePromise(null));
+    });
+}
+//# sourceMappingURL=discover.js.map

package/dist/validation/discover.js.map

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

package/dist/validation/index.d.ts

@@ -0,0 +1,17 @@
+export { runLayer1 } from "./layer1.js";
+export type { Layer1Input, Layer1Finding, Layer1Result } from "./layer1.js";
+export { runLayer2 } from "./layer2.js";
+export type { Layer2Input, Layer2Result } from "./layer2.js";
+export { runLayer3 } from "./layer3.js";
+export type { Layer3Criterion, Layer3Input, Layer3Score, Layer3Result } from "./layer3.js";
+export { captureScreenshot } from "./capture.js";
+export type { CapturePlatform, CaptureInput, CaptureResult } from "./capture.js";
+export { installAndLaunch } from "./launch.js";
+export type { LaunchInput, IosLaunchInput, AndroidLaunchInput, LaunchResult } from "./launch.js";
+export { runVisualJudge, DEFAULT_STAGE1_RUBRIC } from "./visual-judge.js";
+export type { VisualJudgeInput, VisualJudgeResult } from "./visual-judge.js";
+export { discoverIosArtifact, discoverAndroidArtifact } from "./discover.js";
+export type { IosArtifact, AndroidArtifact } from "./discover.js";
+export { runStage1Visual } from "./stage1.js";
+export type { Stage1VisualInput, Stage1VisualResult } from "./stage1.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE5E,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE7D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3F,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAEjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEjG,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE7E,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAC7E,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAElE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}

package/dist/validation/index.js

@@ -0,0 +1,9 @@
+export { runLayer1 } from "./layer1.js";
+export { runLayer2 } from "./layer2.js";
+export { runLayer3 } from "./layer3.js";
+export { captureScreenshot } from "./capture.js";
+export { installAndLaunch } from "./launch.js";
+export { runVisualJudge, DEFAULT_STAGE1_RUBRIC } from "./visual-judge.js";
+export { discoverIosArtifact, discoverAndroidArtifact } from "./discover.js";
+export { runStage1Visual } from "./stage1.js";
+//# sourceMappingURL=index.js.map

package/dist/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAG1E,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAG7E,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/validation/launch.d.ts

@@ -0,0 +1,21 @@
+export type LaunchResult = {
+    ok: boolean;
+    command: string;
+    durationMs: number;
+    error?: string;
+};
+export type IosLaunchInput = {
+    platform: "ios";
+    appPath: string;
+    bundleId: string;
+    timeoutMs?: number;
+};
+export type AndroidLaunchInput = {
+    platform: "android";
+    apkPath: string;
+    packageName: string;
+    timeoutMs?: number;
+};
+export type LaunchInput = IosLaunchInput | AndroidLaunchInput;
+export declare function installAndLaunch(input: LaunchInput): Promise<LaunchResult>;
+//# sourceMappingURL=launch.d.ts.map

package/dist/validation/launch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.d.ts","sourceRoot":"","sources":["../../src/validation/launch.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,KAAK,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,SAAS,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,cAAc,GAAG,kBAAkB,CAAC;AAsB9D,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAQhF"}

package/dist/validation/launch.js

@@ -0,0 +1,109 @@
+import { spawn } from "node:child_process";
+import { scrubbedEnv } from "../env.js";
+import { resolveAdbPath } from "../adb.js";
+const DEFAULT_TIMEOUT_MS = 60_000;
+// Install and launch the generated app on whatever sim/emulator is currently
+// booted. Discovery (finding the .app / .apk artifact, deriving the bundle ID
+// / package name from the slug) is the caller's concern — this function takes
+// already-resolved inputs and runs the install + launch chain.
+//
+// Two-step chain per platform:
+//   iOS:     xcrun simctl install booted <appPath>
+//            xcrun simctl launch  booted <bundleId>
+//   Android: adb install <apkPath>
+//            adb shell monkey -p <package> -c android.intent.category.LAUNCHER 1
+//
+// `monkey` on Android is used over `am start -n <pkg>/<activity>` because it
+// only needs the package name — the caller doesn't have to know which activity
+// is the entry point, just the rename plan's slug-derived package.
+//
+// Screen-readiness polling is NOT done here; the caller should sleep briefly
+// before captureScreenshot() so the home screen has rendered. A future PR may
+// add an explicit ready-poll using accessibility tree or pixel diff.
+export async function installAndLaunch(input) {
+    const timeoutMs = input.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    switch (input.platform) {
+        case "ios":
+            return installAndLaunchIos(input.appPath, input.bundleId, timeoutMs);
+        case "android":
+            return installAndLaunchAndroid(input.apkPath, input.packageName, timeoutMs);
+    }
+}
+async function installAndLaunchIos(appPath, bundleId, timeoutMs) {
+    const started = Date.now();
+    const installCmd = `xcrun simctl install booted ${appPath}`;
+    const launchCmd = `xcrun simctl launch booted ${bundleId}`;
+    const install = await runOnce("xcrun", ["simctl", "install", "booted", appPath], timeoutMs);
+    if (!install.ok) {
+        return {
+            ok: false,
+            command: installCmd,
+            durationMs: Date.now() - started,
+            ...(install.error !== undefined ? { error: install.error } : {}),
+        };
+    }
+    const launch = await runOnce("xcrun", ["simctl", "launch", "booted", bundleId], timeoutMs);
+    return {
+        ok: launch.ok,
+        command: `${installCmd} && ${launchCmd}`,
+        durationMs: Date.now() - started,
+        ...(launch.ok || launch.error === undefined ? {} : { error: launch.error }),
+    };
+}
+async function installAndLaunchAndroid(apkPath, packageName, timeoutMs) {
+    const adb = resolveAdbPath();
+    const started = Date.now();
+    const installCmd = `${adb} install -r ${apkPath}`;
+    const launchCmd = `${adb} shell monkey -p ${packageName} -c android.intent.category.LAUNCHER 1`;
+    const install = await runOnce(adb, ["install", "-r", apkPath], timeoutMs);
+    if (!install.ok) {
+        return {
+            ok: false,
+            command: installCmd,
+            durationMs: Date.now() - started,
+            ...(install.error !== undefined ? { error: install.error } : {}),
+        };
+    }
+    const launch = await runOnce(adb, ["shell", "monkey", "-p", packageName, "-c", "android.intent.category.LAUNCHER", "1"], timeoutMs);
+    return {
+        ok: launch.ok,
+        command: `${installCmd} && ${launchCmd}`,
+        durationMs: Date.now() - started,
+        ...(launch.ok || launch.error === undefined ? {} : { error: launch.error }),
+    };
+}
+function runOnce(cmd, args, timeoutMs) {
+    return new Promise((resolvePromise) => {
+        let child;
+        try {
+            child = spawn(cmd, [...args], { env: scrubbedEnv(), stdio: ["ignore", "pipe", "pipe"] });
+        }
+        catch (err) {
+            resolvePromise({ ok: false, error: err instanceof Error ? err.message : String(err) });
+            return;
+        }
+        const stderrChunks = [];
+        const stdoutChunks = [];
+        child.stderr.on("data", (c) => stderrChunks.push(c));
+        child.stdout.on("data", (c) => stdoutChunks.push(c));
+        const timer = setTimeout(() => { child.kill("SIGTERM"); }, timeoutMs);
+        child.on("close", (code) => {
+            clearTimeout(timer);
+            const stderr = Buffer.concat(stderrChunks).toString("utf8").trim();
+            const stdout = Buffer.concat(stdoutChunks).toString("utf8").trim();
+            // adb install prints success/failure on stdout; non-zero exit alone
+            // isn't always the right signal. Check for explicit failure markers.
+            if (code === 0 && !stdout.toLowerCase().includes("failure")) {
+                resolvePromise({ ok: true });
+            }
+            else {
+                resolvePromise({ ok: false, error: stderr || stdout || `${cmd} exited ${code}` });
+            }
+        });
+        child.on("error", (err) => {
+            clearTimeout(timer);
+            resolvePromise({ ok: false, error: err.message });
+        });
+    });
+}
+//# sourceMappingURL=launch.js.map

package/dist/validation/launch.js.map

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

package/dist/validation/layer1.d.ts

@@ -0,0 +1,16 @@
+export type Layer1Input = {
+    projectDir: string;
+    forbiddenTokens: readonly string[];
+};
+export type Layer1Finding = {
+    token: string;
+    file: string;
+    line: number;
+    text: string;
+};
+export type Layer1Result = {
+    pass: boolean;
+    findings: Layer1Finding[];
+};
+export declare function runLayer1(input: Layer1Input): Promise<Layer1Result>;
+//# sourceMappingURL=layer1.d.ts.map

package/dist/validation/layer1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layer1.d.ts","sourceRoot":"","sources":["../../src/validation/layer1.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,WAAW,GAAG;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B,CAAC;AAyBF,wBAAsB,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAiCzE"}