nativeapptemplate-agent 0.1.0

package/dist/validation/layer1.js

@@ -0,0 +1,98 @@
+import { readdir, readFile, stat } from "node:fs/promises";
+import { extname, join, relative, basename } from "node:path";
+const TEXT_EXTS = new Set([
+    ".rb", ".erb", ".yml", ".yaml", ".json", ".md", ".gemspec", ".rake", ".ru",
+    ".txt", ".sample", ".example", ".conf", ".html", ".css", ".scss", ".js", ".mjs",
+    ".tt", ".lock",
+    ".swift", ".plist", ".strings", ".xcconfig", ".entitlements", ".pbxproj",
+    ".xcworkspacedata", ".modulemap", ".xcscheme",
+    ".kt", ".kts", ".xml", ".gradle", ".pro", ".toml", ".properties", ".cfg",
+    ".proto",
+]);
+const TEXT_BASENAMES = new Set([
+    "Gemfile", "Gemfile.lock", "Rakefile", "Procfile", "Procfile.dev",
+    "config.ru", "Dockerfile",
+    "Podfile", "Podfile.lock", "Package.swift", "Cartfile", "Makefile",
+    "gradlew", "gradlew.bat", "gradle.properties", "local.properties",
+]);
+const SKIP_SEGMENTS = new Set([
+    ".git", "node_modules", "tmp", "log", "vendor",
+    "DerivedData", "Pods", "Carthage", "xcuserdata", ".build",
+    "build", ".gradle", ".idea", ".kotlin", "captures",
+]);
+export async function runLayer1(input) {
+    if (input.forbiddenTokens.length === 0) {
+        return { pass: true, findings: [] };
+    }
+    const root = await realRoot(input.projectDir);
+    if (!root) {
+        return { pass: false, findings: [] };
+    }
+    const regex = buildRegex(input.forbiddenTokens);
+    const findings = [];
+    for await (const filePath of walk(root)) {
+        const content = await safeRead(filePath);
+        if (!content)
+            continue;
+        const lines = content.split("\n");
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            regex.lastIndex = 0;
+            let m;
+            while ((m = regex.exec(line)) !== null) {
+                findings.push({
+                    token: m[0],
+                    file: relative(root, filePath),
+                    line: i + 1,
+                    text: line,
+                });
+            }
+        }
+    }
+    return { pass: findings.length === 0, findings };
+}
+async function realRoot(dir) {
+    try {
+        const s = await stat(dir);
+        return s.isDirectory() ? dir : null;
+    }
+    catch {
+        return null;
+    }
+}
+function buildRegex(tokens) {
+    const escaped = tokens.map(escapeRegex).join("|");
+    return new RegExp(`(?:${escaped})`, "g");
+}
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+async function* walk(dir) {
+    const entries = await readdir(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (SKIP_SEGMENTS.has(entry.name))
+            continue;
+        const full = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            yield* walk(full);
+        }
+        else if (entry.isFile() && isTextFile(full)) {
+            yield full;
+        }
+    }
+}
+function isTextFile(path) {
+    const base = basename(path);
+    if (TEXT_BASENAMES.has(base))
+        return true;
+    return TEXT_EXTS.has(extname(path));
+}
+async function safeRead(path) {
+    try {
+        return await readFile(path, "utf8");
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=layer1.js.map

package/dist/validation/layer1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layer1.js","sourceRoot":"","sources":["../../src/validation/layer1.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAmB9D,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC;IACxB,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK;IAC1E,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM;IAC/E,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,UAAU;IACxE,kBAAkB,EAAE,YAAY,EAAE,WAAW;IAC7C,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM;IACxE,QAAQ;CACT,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC;IAC7B,SAAS,EAAE,cAAc,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc;IACjE,WAAW,EAAE,YAAY;IACzB,SAAS,EAAE,cAAc,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU;IAClE,SAAS,EAAE,aAAa,EAAE,mBAAmB,EAAE,kBAAkB;CAClE,CAAC,CAAC;AAEH,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IAC5B,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ;IAC9C,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ;IACzD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU;CACnD,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAAkB;IAChD,IAAI,KAAK,CAAC,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IACtC,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC9C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IACvC,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAoB,EAAE,CAAC;IAErC,IAAI,KAAK,EAAE,MAAM,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;YACvB,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC;YACpB,IAAI,CAAyB,CAAC;YAC9B,OAAO,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;gBACvC,QAAQ,CAAC,IAAI,CAAC;oBACZ,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;oBACX,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;oBAC9B,IAAI,EAAE,CAAC,GAAG,CAAC;oBACX,IAAI,EAAE,IAAI;iBACX,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;AACnD,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,GAAW;IACjC,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1B,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,MAAyB;IAC3C,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClD,OAAO,IAAI,MAAM,CAAC,MAAM,OAAO,GAAG,EAAE,GAAG,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,WAAW,CAAC,CAAS;IAC5B,OAAO,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AAClD,CAAC;AAED,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,GAAW;IAC9B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,SAAS;QAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9C,MAAM,IAAI,CAAC;QACb,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AACtC,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,IAAY;IAClC,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/validation/layer2.d.ts

@@ -0,0 +1,17 @@
+export type Layer2Platform = "rails" | "ios" | "android";
+export type Layer2Mode = "fast" | "build";
+export type Layer2Input = {
+    platform: Layer2Platform;
+    outDir: string;
+    mode?: Layer2Mode;
+    timeoutMs?: number;
+};
+export type Layer2Result = {
+    pass: boolean;
+    command: string;
+    exitCode: number | null;
+    durationMs: number;
+    stderrTail?: string;
+};
+export declare function runLayer2(input: Layer2Input): Promise<Layer2Result>;
+//# sourceMappingURL=layer2.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"layer2.d.ts","sourceRoot":"","sources":["../../src/validation/layer2.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,KAAK,GAAG,SAAS,CAAC;AAEzD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;AAE1C,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAOF,wBAAsB,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAoBzE"}

package/dist/validation/layer2.js

@@ -0,0 +1,168 @@
+import { spawn } from "node:child_process";
+import { access, readdir } from "node:fs/promises";
+import { scrubbedEnv } from "../env.js";
+const DEFAULT_TIMEOUT_FAST_MS = 300_000;
+const DEFAULT_TIMEOUT_BUILD_MS = 900_000;
+const IOS_DESTINATION = "platform=iOS Simulator,name=iPhone 17,OS=26.2";
+export async function runLayer2(input) {
+    const mode = input.mode ?? "fast";
+    const timeoutMs = input.timeoutMs ?? (mode === "build" ? DEFAULT_TIMEOUT_BUILD_MS : DEFAULT_TIMEOUT_FAST_MS);
+    const start = Date.now();
+    if (!(await exists(input.outDir))) {
+        return {
+            pass: false,
+            command: "stat",
+            exitCode: null,
+            durationMs: Date.now() - start,
+            stderrTail: `outDir does not exist: ${input.outDir}`,
+        };
+    }
+    switch (input.platform) {
+        case "rails": return runRailsLayer2(input.outDir, mode, timeoutMs, start);
+        case "ios": return runIosLayer2(input.outDir, mode, timeoutMs, start);
+        case "android": return runAndroidLayer2(input.outDir, mode, timeoutMs, start);
+    }
+}
+async function runRailsLayer2(outDir, mode, timeoutMs, start) {
+    const useMise = await commandAvailable("mise");
+    const stream = mode === "build";
+    const bundleCheck = await runIn(outDir, ["bundle", "check"], timeoutMs, useMise, false);
+    if (bundleCheck.exitCode !== 0) {
+        const bundleInstall = await runIn(outDir, ["bundle", "install"], timeoutMs, useMise, stream);
+        if (bundleInstall.exitCode !== 0)
+            return failed("bundle install", bundleInstall, start, useMise);
+    }
+    if (mode === "fast") {
+        const routes = await runIn(outDir, ["bin/rails", "routes"], timeoutMs, useMise, false);
+        if (routes.exitCode !== 0)
+            return failed("bin/rails routes", routes, start, useMise);
+        return pass("bin/rails routes", start, useMise);
+    }
+    // Build mode proves "does the generated app boot" without the
+    // test-runner overhead. db:prepare ensures schema is applied;
+    // `rails runner` loads the full app (class graph + initializers +
+    // DB connection). Running `bin/rails test` here is too heavy —
+    // parallel test workers + DB pool + spec-specific test state
+    // can hang or take minutes, which isn't what Layer 2 is for.
+    const dbPrepare = await runIn(outDir, ["bin/rails", "db:prepare"], timeoutMs, useMise, stream);
+    if (dbPrepare.exitCode !== 0)
+        return failed("bin/rails db:prepare", dbPrepare, start, useMise);
+    const runner = await runIn(outDir, ["bin/rails", "runner", "puts 'OK'"], timeoutMs, useMise, stream);
+    if (runner.exitCode !== 0)
+        return failed("bin/rails runner", runner, start, useMise);
+    return pass("bin/rails runner 'puts OK'", start, useMise);
+}
+async function runIosLayer2(outDir, mode, timeoutMs, start) {
+    const xcodeproj = (await readdir(outDir)).find((e) => e.endsWith(".xcodeproj"));
+    if (!xcodeproj) {
+        return {
+            pass: false,
+            command: "find .xcodeproj",
+            exitCode: null,
+            durationMs: Date.now() - start,
+            stderrTail: `no .xcodeproj in ${outDir}`,
+        };
+    }
+    if (mode === "fast") {
+        const list = await runIn(outDir, ["xcodebuild", "-list", "-project", xcodeproj], timeoutMs, false, false);
+        if (list.exitCode !== 0)
+            return failed(`xcodebuild -list -project ${xcodeproj}`, list, start, false);
+        return { pass: true, command: `xcodebuild -list -project ${xcodeproj}`, exitCode: 0, durationMs: Date.now() - start };
+    }
+    const scheme = xcodeproj.replace(/\.xcodeproj$/, "");
+    const args = [
+        "xcodebuild",
+        "-project", xcodeproj,
+        "-scheme", scheme,
+        "-destination", IOS_DESTINATION,
+        "-configuration", "Debug",
+        "build",
+    ];
+    const build = await runIn(outDir, args, timeoutMs, false, true);
+    if (build.exitCode !== 0)
+        return failed(`xcodebuild build -scheme ${scheme}`, build, start, false);
+    return { pass: true, command: `xcodebuild build -scheme ${scheme}`, exitCode: 0, durationMs: Date.now() - start };
+}
+async function runAndroidLayer2(outDir, mode, timeoutMs, start) {
+    const wrapper = await exists(`${outDir}/gradlew`);
+    if (!wrapper) {
+        return {
+            pass: false,
+            command: "stat ./gradlew",
+            exitCode: null,
+            durationMs: Date.now() - start,
+            stderrTail: `no ./gradlew wrapper in ${outDir}`,
+        };
+    }
+    if (mode === "fast") {
+        const version = await runIn(outDir, ["./gradlew", "--version"], timeoutMs, false, false);
+        if (version.exitCode !== 0)
+            return failed("./gradlew --version", version, start, false);
+        return { pass: true, command: "./gradlew --version", exitCode: 0, durationMs: Date.now() - start };
+    }
+    const assemble = await runIn(outDir, ["./gradlew", "assembleDebug", "--no-daemon"], timeoutMs, false, true);
+    if (assemble.exitCode !== 0)
+        return failed("./gradlew assembleDebug", assemble, start, false);
+    return { pass: true, command: "./gradlew assembleDebug", exitCode: 0, durationMs: Date.now() - start };
+}
+function pass(command, start, useMise) {
+    return { pass: true, command: withPrefix(command, useMise), exitCode: 0, durationMs: Date.now() - start };
+}
+function failed(action, result, start, useMise) {
+    return {
+        pass: false,
+        command: withPrefix(action, useMise),
+        exitCode: result.exitCode,
+        durationMs: Date.now() - start,
+        stderrTail: tail(result.stderr, 30),
+    };
+}
+function withPrefix(action, useMise) {
+    return useMise ? `mise exec -- ${action}` : action;
+}
+function runIn(cwd, argv, timeoutMs, useMise, stream) {
+    const [command, ...rest] = useMise ? ["mise", "exec", "--", ...argv] : argv;
+    return new Promise((resolvePromise) => {
+        // Build mode: inherit parent's TTY so Ruby / xcodebuild / gradle
+        // detect a terminal and line-buffer stdout normally. We give up
+        // programmatic stderr capture in exchange — user sees it live.
+        // Fast mode: pipe + drain, silent + fast.
+        const child = stream
+            ? spawn(command, rest, { cwd, stdio: "inherit", env: scrubbedEnv() })
+            : spawn(command, rest, { cwd, stdio: ["ignore", "pipe", "pipe"], env: scrubbedEnv() });
+        const stderrChunks = [];
+        const timer = setTimeout(() => { child.kill("SIGTERM"); }, timeoutMs);
+        if (!stream) {
+            child.stdout?.on("data", () => { });
+            child.stderr?.on("data", (c) => stderrChunks.push(c));
+        }
+        child.on("close", (code) => {
+            clearTimeout(timer);
+            resolvePromise({ exitCode: code, stderr: Buffer.concat(stderrChunks).toString("utf8") });
+        });
+        child.on("error", () => {
+            clearTimeout(timer);
+            resolvePromise({ exitCode: null, stderr: Buffer.concat(stderrChunks).toString("utf8") });
+        });
+    });
+}
+async function commandAvailable(bin) {
+    return new Promise((resolvePromise) => {
+        const c = spawn("which", [bin], { env: scrubbedEnv() });
+        c.on("close", (code) => resolvePromise(code === 0));
+        c.on("error", () => resolvePromise(false));
+    });
+}
+async function exists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function tail(s, lines) {
+    return s.split("\n").slice(-lines).join("\n");
+}
+//# sourceMappingURL=layer2.js.map

package/dist/validation/layer2.js.map

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

package/dist/validation/layer3.d.ts

@@ -0,0 +1,22 @@
+export type Layer3Criterion = {
+    id: string;
+    question: string;
+};
+export type Layer3Input = {
+    screenshotPath: string;
+    rubric: readonly Layer3Criterion[];
+    spec: string;
+    model?: string;
+    samplesPerCriterion?: number;
+};
+export type Layer3Score = {
+    criterionId: string;
+    pass: boolean;
+    rationale: string;
+};
+export type Layer3Result = {
+    pass: boolean;
+    scores: Layer3Score[];
+};
+export declare function runLayer3(input: Layer3Input): Promise<Layer3Result>;
+//# sourceMappingURL=layer3.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"layer3.d.ts","sourceRoot":"","sources":["../../src/validation/layer3.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB,CAAC;AA8BF,wBAAsB,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAgCzE"}

package/dist/validation/layer3.js

@@ -0,0 +1,96 @@
+import Anthropic from "@anthropic-ai/sdk";
+import { readFile } from "node:fs/promises";
+import { isStub } from "../stub.js";
+const DEFAULT_MODEL = "claude-opus-4-7";
+const DEFAULT_SAMPLES = 3;
+const MAX_TOKENS = 1024;
+const SYSTEM_PROMPT = `You are a vision judge for a SaaS code generator. You receive a one-sentence natural-language spec describing a SaaS product and a screenshot of a generated app's home screen, and you assess one rubric criterion at a time.
+
+Score conservatively: when in doubt, answer No. Base the verdict ONLY on what is visible in the screenshot — do not assume features that aren't shown.`;
+const VERDICT_TOOL = {
+    name: "submit_verdict",
+    description: "Record the Yes/No verdict and one-sentence rationale for this rubric criterion.",
+    input_schema: {
+        type: "object",
+        properties: {
+            pass: {
+                type: "boolean",
+                description: "true if the criterion is met based on what is visible in the screenshot; false otherwise. Be conservative — when uncertain, answer false.",
+            },
+            rationale: {
+                type: "string",
+                description: "One-sentence rationale grounded in what is visible.",
+            },
+        },
+        required: ["pass", "rationale"],
+        additionalProperties: false,
+    },
+};
+export async function runLayer3(input) {
+    if (isStub("judge"))
+        return runStubLayer3(input);
+    const samplesPerCriterion = input.samplesPerCriterion ?? DEFAULT_SAMPLES;
+    const model = input.model ?? DEFAULT_MODEL;
+    const png = await readFile(input.screenshotPath);
+    const imageBase64 = png.toString("base64");
+    const apiKey = process.env['NATIVEAPPTEMPLATE_AGENT_ANTHROPIC_KEY'] ?? process.env['ANTHROPIC_API_KEY'];
+    const client = new Anthropic({ apiKey });
+    const scores = await Promise.all(input.rubric.map(async (criterion) => {
+        const samples = await Promise.all(Array.from({ length: samplesPerCriterion }, () => judgeOne(client, model, imageBase64, input.spec, criterion)));
+        const passCount = samples.filter((s) => s.pass).length;
+        const median = passCount > samplesPerCriterion / 2;
+        const winningSample = samples.find((s) => s.pass === median) ?? samples[0];
+        return {
+            criterionId: criterion.id,
+            pass: median,
+            rationale: winningSample.rationale,
+        };
+    }));
+    const pass = scores.every((s) => s.pass);
+    return { pass, scores };
+}
+async function judgeOne(client, model, imageBase64, spec, criterion) {
+    const response = await client.messages.create({
+        model,
+        max_tokens: MAX_TOKENS,
+        system: SYSTEM_PROMPT,
+        tools: [VERDICT_TOOL],
+        tool_choice: { type: "tool", name: "submit_verdict" },
+        messages: [
+            {
+                role: "user",
+                content: [
+                    {
+                        type: "image",
+                        source: { type: "base64", media_type: "image/png", data: imageBase64 },
+                        cache_control: { type: "ephemeral" },
+                    },
+                    {
+                        type: "text",
+                        text: `Spec: ${spec}\n\nCriterion: ${criterion.question}`,
+                    },
+                ],
+            },
+        ],
+    });
+    const toolUse = response.content.find((c) => c.type === "tool_use");
+    if (!toolUse || toolUse.type !== "tool_use") {
+        throw new Error("layer3 judge: expected tool_use in response, got: " + JSON.stringify(response.content));
+    }
+    const verdict = toolUse.input;
+    if (typeof verdict.pass !== "boolean" || typeof verdict.rationale !== "string") {
+        throw new Error("layer3 judge: malformed verdict: " + JSON.stringify(verdict));
+    }
+    return verdict;
+}
+async function runStubLayer3(input) {
+    return {
+        pass: true,
+        scores: input.rubric.map((c) => ({
+            criterionId: c.id,
+            pass: true,
+            rationale: "(stub)",
+        })),
+    };
+}
+//# sourceMappingURL=layer3.js.map

package/dist/validation/layer3.js.map

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

package/dist/validation/stage1.d.ts

@@ -0,0 +1,17 @@
+import { type VisualJudgeResult } from "./visual-judge.js";
+import type { Layer3Criterion } from "./layer3.js";
+export type Stage1VisualInput = {
+    iosDir?: string;
+    androidDir?: string;
+    screenshotDir?: string;
+    spec: string;
+    rubric?: readonly Layer3Criterion[];
+    renderWaitMs?: number;
+    samplesPerCriterion?: number;
+};
+export type Stage1VisualResult = {
+    ios?: VisualJudgeResult;
+    android?: VisualJudgeResult;
+};
+export declare function runStage1Visual(input: Stage1VisualInput): Promise<Stage1VisualResult>;
+//# sourceMappingURL=stage1.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stage1.d.ts","sourceRoot":"","sources":["../../src/validation/stage1.ts"],"names":[],"mappings":"AAGA,OAAO,EAAyC,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAClG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,MAAM,iBAAiB,GAAG;IAE9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,CAAC,EAAE,iBAAiB,CAAC;IACxB,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B,CAAC;AAaF,wBAAsB,eAAe,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA4C3F"}

package/dist/validation/stage1.js

@@ -0,0 +1,71 @@
+import { join } from "node:path";
+import { mkdir } from "node:fs/promises";
+import { discoverIosArtifact, discoverAndroidArtifact } from "./discover.js";
+import { runVisualJudge, DEFAULT_STAGE1_RUBRIC } from "./visual-judge.js";
+// One-call convenience wrapper for the Stage 1 visual judge: discover the
+// pre-built artifact + identifier on each requested platform (#42), then run
+// the install → launch → capture → judge chain (#40, #41) for that platform.
+//
+// Returns a Stage1VisualResult shaped to match JudgeInput.visual's per-
+// platform expectation, so callers can pass it through to runJudge directly.
+//
+// Caller responsibilities:
+//   - Run Layer 2 in build mode first so the .app / .apk exists.
+//   - Ensure a sim/emulator is booted for each platform being judged.
+//   - Pick which platforms to judge — pass undefined for the others.
+export async function runStage1Visual(input) {
+    const screenshotDir = input.screenshotDir ?? join(process.cwd(), "tmp", "screenshots");
+    await mkdir(screenshotDir, { recursive: true });
+    const rubric = input.rubric ?? DEFAULT_STAGE1_RUBRIC;
+    const result = {};
+    if (input.iosDir) {
+        const ios = await discoverIosArtifact(input.iosDir);
+        if (ios) {
+            result.ios = await runVisualJudge({
+                platform: "ios",
+                artifactPath: ios.appPath,
+                bundleId: ios.bundleId,
+                screenshotPath: join(screenshotDir, "ios-home.png"),
+                spec: input.spec,
+                rubric,
+                ...(input.renderWaitMs !== undefined ? { renderWaitMs: input.renderWaitMs } : {}),
+                ...(input.samplesPerCriterion !== undefined ? { samplesPerCriterion: input.samplesPerCriterion } : {}),
+            });
+        }
+        else {
+            result.ios = stubFailure("ios", "iOS artifact not discovered (run Layer 2 build mode first)");
+        }
+    }
+    if (input.androidDir) {
+        const android = await discoverAndroidArtifact(input.androidDir);
+        if (android) {
+            result.android = await runVisualJudge({
+                platform: "android",
+                artifactPath: android.apkPath,
+                packageName: android.packageName,
+                screenshotPath: join(screenshotDir, "android-home.png"),
+                spec: input.spec,
+                rubric,
+                ...(input.renderWaitMs !== undefined ? { renderWaitMs: input.renderWaitMs } : {}),
+                ...(input.samplesPerCriterion !== undefined ? { samplesPerCriterion: input.samplesPerCriterion } : {}),
+            });
+        }
+        else {
+            result.android = stubFailure("android", "Android artifact not discovered (run Layer 2 build mode first)");
+        }
+    }
+    return result;
+}
+function stubFailure(platform, error) {
+    return {
+        ok: false,
+        launch: {
+            ok: false,
+            command: `discover ${platform} artifact`,
+            durationMs: 0,
+            error,
+        },
+        error,
+    };
+}
+//# sourceMappingURL=stage1.js.map

package/dist/validation/stage1.js.map

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

package/dist/validation/visual-judge.d.ts

@@ -0,0 +1,25 @@
+import { type Layer3Criterion, type Layer3Result } from "./layer3.js";
+import { type CapturePlatform } from "./capture.js";
+import { type LaunchResult } from "./launch.js";
+export type VisualJudgeInput = {
+    platform: CapturePlatform;
+    artifactPath: string;
+    bundleId?: string;
+    packageName?: string;
+    screenshotPath: string;
+    spec: string;
+    rubric: readonly Layer3Criterion[];
+    renderWaitMs?: number;
+    samplesPerCriterion?: number;
+    model?: string;
+};
+export type VisualJudgeResult = {
+    ok: boolean;
+    launch: LaunchResult;
+    screenshotPath?: string;
+    layer3?: Layer3Result;
+    error?: string;
+};
+export declare function runVisualJudge(input: VisualJudgeInput): Promise<VisualJudgeResult>;
+export declare const DEFAULT_STAGE1_RUBRIC: readonly Layer3Criterion[];
+//# sourceMappingURL=visual-judge.d.ts.map

package/dist/validation/visual-judge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual-judge.d.ts","sourceRoot":"","sources":["../../src/validation/visual-judge.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,KAAK,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAElE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,eAAe,CAAC;IAE1B,YAAY,EAAE,MAAM,CAAC;IAErB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IAGnC,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,YAAY,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAcF,wBAAsB,cAAc,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAkDxF;AAeD,eAAO,MAAM,qBAAqB,EAAE,SAAS,eAAe,EAW3D,CAAC"}