@eidra-umain/greenlight 0.1.0

package/dist/cli/run.js

@@ -0,0 +1,277 @@
+import { loadSuite } from "../parser/loader.js";
+import { launchBrowser, createContext, createPage, closeBrowser, toBrowserOptions, } from "../browser/browser.js";
+import { attachConsoleCollector, attachNetworkTracker, } from "../pilot/network.js";
+import { resolveLLMConfig, createLLMClient, } from "../pilot/llm.js";
+import { runTestCase } from "../pilot/pilot.js";
+import { computeTestHash, slugify } from "../planner/hasher.js";
+import { loadHashIndex, saveHashIndex, loadPlan, savePlan, ensureGitignore, } from "../planner/plan-store.js";
+import { createPlanRecorder } from "../planner/plan-generator.js";
+import { runCachedPlan } from "../planner/plan-runner.js";
+import { resolveModelConfig } from "../types.js";
+import { globals } from "../globals.js";
+/** Print step-by-step results for a test case. */
+function printStepResults(result) {
+    for (const stepResult of result.steps) {
+        const icon = stepResult.status === "passed"
+            ? "\x1b[32m\u2713\x1b[0m"
+            : "\x1b[31m\u2717\x1b[0m";
+        const dur = `${String(Math.round(stepResult.duration))}ms`;
+        const t = stepResult.timing;
+        const phases = t
+            ? ` \x1b[90m[capture:${String(Math.round(t.capture))} llm:${String(Math.round(t.llm))} exec:${String(Math.round(t.execute))} post:${String(Math.round(t.postCapture))}ms]\x1b[0m`
+            : "";
+        console.log(`    ${icon} ${stepResult.step} (${dur})${phases}`);
+        if (stepResult.error) {
+            console.log(`      \x1b[31m${stepResult.error}\x1b[0m`);
+        }
+        if (globals.debug && stepResult.action) {
+            console.log(`      Action: ${JSON.stringify(stepResult.action)}`);
+        }
+    }
+}
+/** Print pass/fail summary for a test case. */
+function printTestSummary(result) {
+    const modeTag = result.mode === "cached" ? " \x1b[36m[cached]\x1b[0m" : "";
+    const testIcon = result.status === "passed"
+        ? "\x1b[32mPASSED\x1b[0m"
+        : "\x1b[31mFAILED\x1b[0m";
+    console.log(`\n  ${testIcon}${modeTag} (${String(Math.round(result.duration))}ms)`);
+}
+/** Show plan status for all test cases across all suites. */
+export async function showPlanStatus(suiteFiles, cwd, config) {
+    const hashIndex = await loadHashIndex(cwd);
+    for (const file of suiteFiles) {
+        let suite;
+        try {
+            suite = await loadSuite(file);
+        }
+        catch (err) {
+            console.error(`Failed to load suite: ${file}`);
+            if (err instanceof Error)
+                console.error(err.message);
+            continue;
+        }
+        const suiteSlug = slugify(suite.suite);
+        const tests = config.testFilter
+            ? suite.tests.filter((t) => t.name === config.testFilter)
+            : suite.tests;
+        console.log(`\nSuite: ${suite.suite}`);
+        for (const test of tests) {
+            const testSlug = slugify(test.name);
+            const testHash = computeTestHash(test);
+            const hashKey = `${suiteSlug}/${testSlug}`;
+            const cachedHash = hashIndex[hashKey];
+            if (!cachedHash) {
+                console.log(`  ${hashKey}: \x1b[33mno cached plan\x1b[0m`);
+            }
+            else if (cachedHash !== testHash) {
+                console.log(`  ${hashKey}: \x1b[33mstale\x1b[0m (definition changed)`);
+            }
+            else {
+                const plan = await loadPlan(cwd, suiteSlug, testSlug);
+                if (plan) {
+                    console.log(`  ${hashKey}: \x1b[32mcached\x1b[0m (hash: ${cachedHash.slice(0, 8)}, generated: ${plan.generatedAt.split("T")[0]})`);
+                }
+                else {
+                    console.log(`  ${hashKey}: \x1b[33mhash exists but plan file missing\x1b[0m`);
+                }
+            }
+        }
+    }
+}
+/**
+ * Run all test suites according to the resolved configuration.
+ * This is the main test execution entry point called by the CLI.
+ */
+export async function runCommand(config, resolvedFiles) {
+    const cwd = process.cwd();
+    // Load and run each suite
+    for (const file of resolvedFiles) {
+        // Load suite
+        let suite;
+        try {
+            suite = await loadSuite(file);
+        }
+        catch (err) {
+            console.error(`\nFailed to load suite: ${file}`);
+            if (err instanceof Error)
+                console.error(err.message);
+            process.exit(1);
+        }
+        // Resolve base URL: CLI flag > deployment/config > suite
+        const baseUrl = config.baseUrl ?? suite.base_url;
+        if (!baseUrl) {
+            console.error(`No base_url for suite "${suite.suite}". Set it in the suite YAML, greenlight.yaml, or pass --base-url.`);
+            process.exit(1);
+        }
+        suite.base_url = baseUrl;
+        // Apply suite-level model override
+        const effectiveModel = suite.model ?? config.model;
+        const suiteSlug = slugify(suite.suite);
+        const resolved = resolveModelConfig(effectiveModel);
+        console.log(`\nSuite: ${suite.suite}`);
+        console.log(`URL:   ${baseUrl}`);
+        console.log(`Provider: ${config.provider}`);
+        if (resolved.planner === resolved.pilot) {
+            console.log(`Model: ${resolved.planner}`);
+        }
+        else {
+            console.log(`Model: planner=${resolved.planner}, pilot=${resolved.pilot}`);
+        }
+        // Load hash index for plan caching
+        const hashIndex = await loadHashIndex(cwd);
+        // LLM client — created lazily, only when a test needs discovery
+        let llm;
+        function getOrCreateLLM() {
+            if (!llm) {
+                const llmConfig = resolveLLMConfig({
+                    ...config,
+                    model: effectiveModel,
+                });
+                llm = createLLMClient(llmConfig);
+            }
+            return llm;
+        }
+        // Launch browser
+        const browserOpts = toBrowserOptions(config);
+        let browser;
+        try {
+            browser = await launchBrowser(browserOpts);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(`\nFailed to launch browser: ${msg}`);
+            process.exit(1);
+        }
+        let hashIndexDirty = false;
+        try {
+            // Filter tests
+            const tests = config.testFilter
+                ? suite.tests.filter((t) => t.name === config.testFilter)
+                : suite.tests;
+            for (const test of tests) {
+                const testSlug = slugify(test.name);
+                const testHash = computeTestHash(test);
+                const hashKey = `${suiteSlug}/${testSlug}`;
+                const cachedHash = hashIndex[hashKey];
+                // Determine execution mode
+                let useCachedPlan = false;
+                let cachedPlan = null;
+                if (!config.discover && cachedHash === testHash) {
+                    cachedPlan = await loadPlan(cwd, suiteSlug, testSlug);
+                    if (cachedPlan) {
+                        useCachedPlan = true;
+                    }
+                }
+                const modeLabel = useCachedPlan
+                    ? "\x1b[36mcached\x1b[0m"
+                    : "\x1b[33mdiscovery\x1b[0m";
+                console.log(`\n  Test: ${test.name} [${modeLabel}]`);
+                if (!config.discover &&
+                    cachedHash &&
+                    cachedHash !== testHash) {
+                    console.log(`    \x1b[33mPlan stale, re-discovering\x1b[0m`);
+                }
+                // Fresh context per test case
+                const context = await createContext(browser, browserOpts);
+                const page = await createPage(context);
+                const { drain } = attachConsoleCollector(page);
+                const { waitForNetworkIdle } = attachNetworkTracker(page);
+                globals.trace.attachToPage(page);
+                try {
+                    globals.trace.log("goto", suite.base_url);
+                    await page.goto(suite.base_url);
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    console.error(`\n  \x1b[31m\u2717\x1b[0m Failed to navigate to ${suite.base_url}: ${msg}`);
+                    globals.trace.detachFromPage(page);
+                    await context.close();
+                    continue;
+                }
+                let result;
+                if (useCachedPlan && cachedPlan) {
+                    // Fast run — replay cached plan
+                    result = await runCachedPlan(page, cachedPlan, test.name, { waitForNetworkIdle });
+                    // Handle plan drift
+                    if (result.drifted && config.onDrift === "rerun") {
+                        console.log(`    \x1b[33mPlan drift detected, re-running with LLM\x1b[0m`);
+                        // Close and re-create context for fresh state
+                        globals.trace.detachFromPage(page);
+                        await context.close();
+                        const ctx2 = await createContext(browser, browserOpts);
+                        const page2 = await createPage(ctx2);
+                        const { drain: drain2 } = attachConsoleCollector(page2);
+                        const { waitForNetworkIdle: waitForNetworkIdle2 } = attachNetworkTracker(page2);
+                        globals.trace.attachToPage(page2);
+                        await page2.goto(suite.base_url);
+                        const modelLabel = typeof effectiveModel === "string"
+                            ? effectiveModel
+                            : `${effectiveModel.planner}/${effectiveModel.pilot}`;
+                        const recorder = createPlanRecorder(suiteSlug, testSlug, testHash, modelLabel);
+                        result = await runTestCase(page2, test, getOrCreateLLM(), {
+                            timeout: config.timeout,
+                            consoleDrain: drain2,
+                            recorder,
+                            waitForNetworkIdle: waitForNetworkIdle2,
+                        });
+                        result.mode = "discovery";
+                        if (result.status === "passed") {
+                            const plan = recorder.finalize();
+                            await savePlan(cwd, plan);
+                            hashIndex[hashKey] = testHash;
+                            hashIndexDirty = true;
+                            await ensureGitignore(cwd);
+                            console.log(`    \x1b[32mCached plan updated\x1b[0m`);
+                        }
+                        globals.trace.detachFromPage(page2);
+                        await ctx2.close();
+                        printStepResults(result);
+                        printTestSummary(result);
+                        if (config.headed) {
+                            await new Promise((r) => setTimeout(r, 2000));
+                        }
+                        continue;
+                    }
+                }
+                else {
+                    // Discovery run — full LLM loop with recorder
+                    const discoveryModelLabel = typeof effectiveModel === "string"
+                        ? effectiveModel
+                        : `${effectiveModel.planner}/${effectiveModel.pilot}`;
+                    const recorder = createPlanRecorder(suiteSlug, testSlug, testHash, discoveryModelLabel);
+                    result = await runTestCase(page, test, getOrCreateLLM(), {
+                        timeout: config.timeout,
+                        consoleDrain: drain,
+                        recorder,
+                        waitForNetworkIdle,
+                    });
+                    result.mode = "discovery";
+                    // Save plan only if the test passed
+                    if (result.status === "passed") {
+                        const plan = recorder.finalize();
+                        await savePlan(cwd, plan);
+                        hashIndex[hashKey] = testHash;
+                        hashIndexDirty = true;
+                        await ensureGitignore(cwd);
+                        console.log(`    \x1b[32mCached plan generated for: ${test.name}\x1b[0m`);
+                    }
+                }
+                printStepResults(result);
+                printTestSummary(result);
+                if (config.headed) {
+                    await new Promise((r) => setTimeout(r, 2000));
+                }
+                globals.trace.detachFromPage(page);
+                await context.close();
+            }
+        }
+        finally {
+            if (hashIndexDirty) {
+                await saveHashIndex(cwd, hashIndex);
+            }
+            await closeBrowser(browser);
+        }
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/cli/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/cli/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAC/C,OAAO,EACN,aAAa,EACb,aAAa,EACb,UAAU,EACV,YAAY,EACZ,gBAAgB,GAChB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACN,sBAAsB,EACtB,oBAAoB,GACpB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACN,gBAAgB,EAChB,eAAe,GAEf,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAC/D,OAAO,EACN,aAAa,EACb,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,eAAe,GACf,MAAM,0BAA0B,CAAA;AACjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAA;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAGzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAEvC,kDAAkD;AAClD,SAAS,gBAAgB,CAAC,MAAsB;IAC/C,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACvC,MAAM,IAAI,GACT,UAAU,CAAC,MAAM,KAAK,QAAQ;YAC7B,CAAC,CAAC,uBAAuB;YACzB,CAAC,CAAC,uBAAuB,CAAA;QAC3B,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAA;QAC1D,MAAM,CAAC,GAAG,UAAU,CAAC,MAAM,CAAA;QAC3B,MAAM,MAAM,GAAG,CAAC;YACf,CAAC,CAAC,qBAAqB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,YAAY;YACjL,CAAC,CAAC,EAAE,CAAA;QACL,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,IAAI,UAAU,CAAC,IAAI,KAAK,GAAG,IAAI,MAAM,EAAE,CAAC,CAAA;QAC/D,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,iBAAiB,UAAU,CAAC,KAAK,SAAS,CAAC,CAAA;QACxD,CAAC;QACD,IAAI,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;YACxC,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QAClE,CAAC;IACF,CAAC;AACF,CAAC;AAED,+CAA+C;AAC/C,SAAS,gBAAgB,CAAC,MAAsB;IAC/C,MAAM,OAAO,GACZ,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,EAAE,CAAA;IAC3D,MAAM,QAAQ,GACb,MAAM,CAAC,MAAM,KAAK,QAAQ;QACzB,CAAC,CAAC,uBAAuB;QACzB,CAAC,CAAC,uBAAuB,CAAA;IAC3B,OAAO,CAAC,GAAG,CACV,OAAO,QAAQ,GAAG,OAAO,KAAK,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CACtE,CAAA;AACF,CAAC;AAED,6DAA6D;AAC7D,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,UAAoB,EACpB,GAAW,EACX,MAAiB;IAEjB,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,CAAA;IAE1C,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC/B,IAAI,KAAK,CAAA;QACT,IAAI,CAAC;YACJ,KAAK,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,CAAA;QAC9B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,OAAO,CAAC,KAAK,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAA;YAC9C,IAAI,GAAG,YAAY,KAAK;gBAAE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;YACpD,SAAQ;QACT,CAAC;QAED,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QACtC,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU;YAC9B,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,UAAU,CAAC;YACzD,CAAC,CAAC,KAAK,CAAC,KAAK,CAAA;QAEd,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,KAAK,EAAE,CAAC,CAAA;QAEtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YAC1B,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACnC,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,CAAA;YACtC,MAAM,OAAO,GAAG,GAAG,SAAS,IAAI,QAAQ,EAAE,CAAA;YAC1C,MAAM,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,CAAA;YAErC,IAAI,CAAC,UAAU,EAAE,CAAC;gBACjB,OAAO,CAAC,GAAG,CACV,KAAK,OAAO,iCAAiC,CAC7C,CAAA;YACF,CAAC;iBAAM,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;gBACpC,OAAO,CAAC,GAAG,CACV,KAAK,OAAO,6CAA6C,CACzD,CAAA;YACF,CAAC;iBAAM,CAAC;gBACP,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAA;gBACrD,IAAI,IAAI,EAAE,CAAC;oBACV,OAAO,CAAC,GAAG,CACV,KAAK,OAAO,kCAAkC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,gBAAgB,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CACrH,CAAA;gBACF,CAAC;qBAAM,CAAC;oBACP,OAAO,CAAC,GAAG,CACV,KAAK,OAAO,oDAAoD,CAChE,CAAA;gBACF,CAAC;YACF,CAAC;QACF,CAAC;IACF,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC/B,MAAiB,EACjB,aAAuB;IAEvB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAA;IAEzB,0BAA0B;IAC1B,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;QAClC,aAAa;QACb,IAAI,KAAK,CAAA;QACT,IAAI,CAAC;YACJ,KAAK,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,CAAA;QAC9B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,OAAO,CAAC,KAAK,CAAC,2BAA2B,IAAI,EAAE,CAAC,CAAA;YAChD,IAAI,GAAG,YAAY,KAAK;gBAAE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;YACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAChB,CAAC;QAED,yDAAyD;QACzD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,KAAK,CAAC,QAAQ,CAAA;QAChD,IAAI,CAAC,OAAO,EAAE,CAAC;YACd,OAAO,CAAC,KAAK,CACZ,0BAA0B,KAAK,CAAC,KAAK,mEAAmE,CACxG,CAAA;YACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAChB,CAAC;QACD,KAAK,CAAC,QAAQ,GAAG,OAAO,CAAA;QAExB,mCAAmC;QACnC,MAAM,cAAc,GAAG,KAAK,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAA;QAClD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QACtC,MAAM,QAAQ,GAAG,kBAAkB,CAAC,cAAc,CAAC,CAAA;QAEnD,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,KAAK,EAAE,CAAC,CAAA;QACtC,OAAO,CAAC,GAAG,CAAC,UAAU,OAAO,EAAE,CAAC,CAAA;QAChC,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAA;QAC3C,IAAI,QAAQ,CAAC,OAAO,KAAK,QAAQ,CAAC,KAAK,EAAE,CAAC;YACzC,OAAO,CAAC,GAAG,CAAC,UAAU,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAA;QAC1C,CAAC;aAAM,CAAC;YACP,OAAO,CAAC,GAAG,CACV,kBAAkB,QAAQ,CAAC,OAAO,WAAW,QAAQ,CAAC,KAAK,EAAE,CAC7D,CAAA;QACF,CAAC;QAED,mCAAmC;QACnC,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,CAAA;QAE1C,gEAAgE;QAChE,IAAI,GAA0B,CAAA;QAE9B,SAAS,cAAc;YACtB,IAAI,CAAC,GAAG,EAAE,CAAC;gBACV,MAAM,SAAS,GAAG,gBAAgB,CAAC;oBAClC,GAAG,MAAM;oBACT,KAAK,EAAE,cAAc;iBACrB,CAAC,CAAA;gBACF,GAAG,GAAG,eAAe,CAAC,SAAS,CAAC,CAAA;YACjC,CAAC;YACD,OAAO,GAAG,CAAA;QACX,CAAC;QAED,iBAAiB;QACjB,MAAM,WAAW,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAA;QAC5C,IAAI,OAAO,CAAA;QACX,IAAI,CAAC;YACJ,OAAO,GAAG,MAAM,aAAa,CAAC,WAAW,CAAC,CAAA;QAC3C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YAC5D,OAAO,CAAC,KAAK,CAAC,+BAA+B,GAAG,EAAE,CAAC,CAAA;YACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAChB,CAAC;QAED,IAAI,cAAc,GAAG,KAAK,CAAA;QAE1B,IAAI,CAAC;YACJ,eAAe;YACf,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU;gBAC9B,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,UAAU,CAAC;gBACzD,CAAC,CAAC,KAAK,CAAC,KAAK,CAAA;YAEd,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBAC1B,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBACnC,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,CAAA;gBACtC,MAAM,OAAO,GAAG,GAAG,SAAS,IAAI,QAAQ,EAAE,CAAA;gBAC1C,MAAM,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,CAAA;gBAErC,2BAA2B;gBAC3B,IAAI,aAAa,GAAG,KAAK,CAAA;gBACzB,IAAI,UAAU,GAAG,IAAI,CAAA;gBAErB,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;oBACjD,UAAU,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAA;oBACrD,IAAI,UAAU,EAAE,CAAC;wBAChB,aAAa,GAAG,IAAI,CAAA;oBACrB,CAAC;gBACF,CAAC;gBAED,MAAM,SAAS,GAAG,aAAa;oBAC9B,CAAC,CAAC,uBAAuB;oBACzB,CAAC,CAAC,0BAA0B,CAAA;gBAC7B,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,CAAC,IAAI,KAAK,SAAS,GAAG,CAAC,CAAA;gBAEpD,IACC,CAAC,MAAM,CAAC,QAAQ;oBAChB,UAAU;oBACV,UAAU,KAAK,QAAQ,EACtB,CAAC;oBACF,OAAO,CAAC,GAAG,CACV,+CAA+C,CAC/C,CAAA;gBACF,CAAC;gBAED,8BAA8B;gBAC9B,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;gBACzD,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,CAAA;gBACtC,MAAM,EAAE,KAAK,EAAE,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAA;gBAC9C,MAAM,EAAE,kBAAkB,EAAE,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAA;gBACzD,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAA;gBAEhC,IAAI,CAAC;oBACJ,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAA;oBACzC,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;gBAChC,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACd,MAAM,GAAG,GACR,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;oBACjD,OAAO,CAAC,KAAK,CACZ,mDAAmD,KAAK,CAAC,QAAQ,KAAK,GAAG,EAAE,CAC3E,CAAA;oBACD,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,CAAA;oBAClC,MAAM,OAAO,CAAC,KAAK,EAAE,CAAA;oBACrB,SAAQ;gBACT,CAAC;gBAED,IAAI,MAAsB,CAAA;gBAE1B,IAAI,aAAa,IAAI,UAAU,EAAE,CAAC;oBACjC,gCAAgC;oBAChC,MAAM,GAAG,MAAM,aAAa,CAC3B,IAAI,EACJ,UAAU,EACV,IAAI,CAAC,IAAI,EACT,EAAE,kBAAkB,EAAE,CACtB,CAAA;oBAED,oBAAoB;oBACpB,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;wBAClD,OAAO,CAAC,GAAG,CACV,6DAA6D,CAC7D,CAAA;wBACD,8CAA8C;wBAC9C,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,CAAA;wBAClC,MAAM,OAAO,CAAC,KAAK,EAAE,CAAA;wBAErB,MAAM,IAAI,GAAG,MAAM,aAAa,CAC/B,OAAO,EACP,WAAW,CACX,CAAA;wBACD,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAA;wBACpC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GACtB,sBAAsB,CAAC,KAAK,CAAC,CAAA;wBAC9B,MAAM,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,GAChD,oBAAoB,CAAC,KAAK,CAAC,CAAA;wBAC5B,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,CAAA;wBACjC,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;wBAEhC,MAAM,UAAU,GACf,OAAO,cAAc,KAAK,QAAQ;4BACjC,CAAC,CAAC,cAAc;4BAChB,CAAC,CAAC,GAAG,cAAc,CAAC,OAAO,IAAI,cAAc,CAAC,KAAK,EAAE,CAAA;wBACvD,MAAM,QAAQ,GAAG,kBAAkB,CAClC,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,UAAU,CACV,CAAA;wBACD,MAAM,GAAG,MAAM,WAAW,CACzB,KAAK,EACL,IAAI,EACJ,cAAc,EAAE,EAChB;4BACC,OAAO,EAAE,MAAM,CAAC,OAAO;4BACvB,YAAY,EAAE,MAAM;4BACpB,QAAQ;4BACR,kBAAkB,EAAE,mBAAmB;yBACvC,CACD,CAAA;wBACD,MAAM,CAAC,IAAI,GAAG,WAAW,CAAA;wBAEzB,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;4BAChC,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAA;4BAChC,MAAM,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;4BACzB,SAAS,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAA;4BAC7B,cAAc,GAAG,IAAI,CAAA;4BACrB,MAAM,eAAe,CAAC,GAAG,CAAC,CAAA;4BAC1B,OAAO,CAAC,GAAG,CACV,wCAAwC,CACxC,CAAA;wBACF,CAAC;wBAED,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,CAAA;wBACnC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAA;wBAClB,gBAAgB,CAAC,MAAM,CAAC,CAAA;wBACxB,gBAAgB,CAAC,MAAM,CAAC,CAAA;wBACxB,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;4BACnB,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CACvB,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,CACnB,CAAA;wBACF,CAAC;wBACD,SAAQ;oBACT,CAAC;gBACF,CAAC;qBAAM,CAAC;oBACP,8CAA8C;oBAC9C,MAAM,mBAAmB,GACxB,OAAO,cAAc,KAAK,QAAQ;wBACjC,CAAC,CAAC,cAAc;wBAChB,CAAC,CAAC,GAAG,cAAc,CAAC,OAAO,IAAI,cAAc,CAAC,KAAK,EAAE,CAAA;oBACvD,MAAM,QAAQ,GAAG,kBAAkB,CAClC,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,mBAAmB,CACnB,CAAA;oBAED,MAAM,GAAG,MAAM,WAAW,CACzB,IAAI,EACJ,IAAI,EACJ,cAAc,EAAE,EAChB;wBACC,OAAO,EAAE,MAAM,CAAC,OAAO;wBACvB,YAAY,EAAE,KAAK;wBACnB,QAAQ;wBACR,kBAAkB;qBAClB,CACD,CAAA;oBACD,MAAM,CAAC,IAAI,GAAG,WAAW,CAAA;oBAEzB,oCAAoC;oBACpC,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;wBAChC,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAA;wBAChC,MAAM,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;wBACzB,SAAS,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAA;wBAC7B,cAAc,GAAG,IAAI,CAAA;wBACrB,MAAM,eAAe,CAAC,GAAG,CAAC,CAAA;wBAC1B,OAAO,CAAC,GAAG,CACV,0CAA0C,IAAI,CAAC,IAAI,SAAS,CAC5D,CAAA;oBACF,CAAC;gBACF,CAAC;gBAED,gBAAgB,CAAC,MAAM,CAAC,CAAA;gBACxB,gBAAgB,CAAC,MAAM,CAAC,CAAA;gBAExB,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;oBACnB,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA;gBAC9C,CAAC;gBAED,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,CAAA;gBAClC,MAAM,OAAO,CAAC,KAAK,EAAE,CAAA;YACtB,CAAC;QACF,CAAC;gBAAS,CAAC;YACV,IAAI,cAAc,EAAE,CAAC;gBACpB,MAAM,aAAa,CAAC,GAAG,EAAE,SAAS,CAAC,CAAA;YACpC,CAAC;YACD,MAAM,YAAY,CAAC,OAAO,CAAC,CAAA;QAC5B,CAAC;IACF,CAAC;AACF,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Load project-level configuration from greenlight.yaml.
+ *
+ * Supports multiple deployments. Each deployment can override any config field.
+ * If only one deployment exists it is used automatically. Otherwise the file
+ * must specify `default_deployment` or the user must pass `--deployment`.
+ */
+import { z } from "zod";
+/** Fields that can appear at the top level or inside a deployment. */
+declare const ConfigFieldsSchema: z.ZodObject<{
+    base_url: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        planner: z.ZodString;
+        pilot: z.ZodString;
+    }, z.core.$strip>]>>;
+    provider: z.ZodOptional<z.ZodEnum<{
+        openrouter: "openrouter";
+        openai: "openai";
+        gemini: "gemini";
+        claude: "claude";
+    }>>;
+    llm_base_url: z.ZodOptional<z.ZodString>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    headed: z.ZodOptional<z.ZodBoolean>;
+    parallel: z.ZodOptional<z.ZodNumber>;
+    reporter: z.ZodOptional<z.ZodEnum<{
+        cli: "cli";
+        json: "json";
+        html: "html";
+    }>>;
+    viewport: z.ZodOptional<z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** The resolved config after selecting a deployment. */
+export type ProjectConfig = z.infer<typeof ConfigFieldsSchema> & {
+    suites: string[];
+};
+/**
+ * Try to load greenlight.yaml from the current working directory.
+ * Returns the parsed and deployment-resolved config, or undefined if the file doesn't exist.
+ *
+ * @param deploymentFlag - The --deployment CLI flag value, if provided.
+ */
+export declare function loadProjectConfig(deploymentFlag?: string, cwd?: string): Promise<ProjectConfig | undefined>;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,sEAAsE;AACtE,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;iBAoBtB,CAAA;AAUF,wDAAwD;AACxD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,GAAG;IAChE,MAAM,EAAE,MAAM,EAAE,CAAA;CAChB,CAAA;AAID;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACtC,cAAc,CAAC,EAAE,MAAM,EACvB,GAAG,GAAE,MAAsB,GACzB,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAapC"}

package/dist/config.js

@@ -0,0 +1,107 @@
+/**
+ * Load project-level configuration from greenlight.yaml.
+ *
+ * Supports multiple deployments. Each deployment can override any config field.
+ * If only one deployment exists it is used automatically. Otherwise the file
+ * must specify `default_deployment` or the user must pass `--deployment`.
+ */
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { parse as parseYaml } from "yaml";
+import { z } from "zod";
+/** Fields that can appear at the top level or inside a deployment. */
+const ConfigFieldsSchema = z.object({
+    base_url: z.string().optional(),
+    model: z
+        .union([
+        z.string().min(1),
+        z.object({ planner: z.string().min(1), pilot: z.string().min(1) }),
+    ])
+        .optional(),
+    provider: z.enum(["openrouter", "openai", "gemini", "claude"]).optional(),
+    llm_base_url: z.string().optional(),
+    timeout: z.number().int().positive().optional(),
+    headed: z.boolean().optional(),
+    parallel: z.number().int().positive().optional(),
+    reporter: z.enum(["cli", "json", "html"]).optional(),
+    viewport: z
+        .object({
+        width: z.number().int().positive(),
+        height: z.number().int().positive(),
+    })
+        .optional(),
+});
+const ProjectConfigSchema = ConfigFieldsSchema.extend({
+    suites: z.array(z.string().min(1)).min(1),
+    deployments: z.record(z.string(), ConfigFieldsSchema).optional(),
+    default_deployment: z.string().optional(),
+});
+const CONFIG_FILE = "greenlight.yaml";
+/**
+ * Try to load greenlight.yaml from the current working directory.
+ * Returns the parsed and deployment-resolved config, or undefined if the file doesn't exist.
+ *
+ * @param deploymentFlag - The --deployment CLI flag value, if provided.
+ */
+export async function loadProjectConfig(deploymentFlag, cwd = process.cwd()) {
+    const configPath = resolve(cwd, CONFIG_FILE);
+    let raw;
+    try {
+        raw = await readFile(configPath, "utf-8");
+    }
+    catch {
+        return undefined;
+    }
+    const data = parseYaml(raw);
+    const parsed = ProjectConfigSchema.parse(data);
+    return resolveDeployment(parsed, deploymentFlag);
+}
+/**
+ * Select a deployment and merge its fields over the top-level config.
+ */
+function resolveDeployment(parsed, deploymentFlag) {
+    const { deployments, default_deployment, suites, ...topLevel } = parsed;
+    const deploymentNames = Object.keys(deployments ?? {});
+    // No deployments section — use top-level config as-is
+    if (deploymentNames.length === 0) {
+        return { ...topLevel, suites };
+    }
+    // Determine which deployment to use
+    let name;
+    if (deploymentFlag) {
+        name = deploymentFlag;
+    }
+    else if (deploymentNames.length === 1) {
+        name = deploymentNames[0];
+    }
+    else if (default_deployment) {
+        name = default_deployment;
+    }
+    else {
+        console.error(`Multiple deployments found (${deploymentNames.join(", ")}) but no default specified.\n` +
+            `Set default_deployment in greenlight.yaml or pass --deployment <name>.`);
+        process.exit(1);
+    }
+    const deployment = deployments?.[name];
+    if (!deployment) {
+        console.error(`Deployment "${name}" not found. Available: ${deploymentNames.join(", ")}`);
+        process.exit(1);
+    }
+    // Merge: deployment fields override top-level fields
+    return {
+        ...topLevel,
+        ...stripUndefined(deployment),
+        suites,
+    };
+}
+/** Remove keys with undefined values so they don't override top-level values during spread. */
+function stripUndefined(obj) {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (value !== undefined) {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/globals.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Global runtime state — set once at CLI startup, read anywhere.
+ * Eliminates the need to thread debug/trace through every function signature.
+ */
+import type { TraceLogger } from "./pilot/trace.js";
+export declare const globals: {
+    /** Verbose debug output (--debug). */
+    debug: boolean;
+    /** Trace logger instance (--trace). Always present; no-op when tracing is disabled. */
+    trace: TraceLogger;
+    /** Value store for remember/compare across steps within a test case. */
+    valueStore: Map<string, string>;
+};
+/**
+ * Initialize globals from CLI options. Call once at startup.
+ */
+export declare function initGlobals(opts: {
+    debug: boolean;
+    trace: TraceLogger;
+}): void;
+//# sourceMappingURL=globals.d.ts.map

package/dist/globals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"globals.d.ts","sourceRoot":"","sources":["../src/globals.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD,eAAO,MAAM,OAAO;IACnB,sCAAsC;;IAEtC,uFAAuF;WAKlF,WAAW;IAChB,wEAAwE;;CAExE,CAAA;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE;IACjC,KAAK,EAAE,OAAO,CAAA;IACd,KAAK,EAAE,WAAW,CAAA;CAClB,GAAG,IAAI,CAGP"}

package/dist/globals.js

@@ -0,0 +1,24 @@
+/**
+ * Global runtime state — set once at CLI startup, read anywhere.
+ * Eliminates the need to thread debug/trace through every function signature.
+ */
+export const globals = {
+    /** Verbose debug output (--debug). */
+    debug: false,
+    /** Trace logger instance (--trace). Always present; no-op when tracing is disabled. */
+    trace: {
+        log() { },
+        attachToPage() { },
+        detachFromPage() { },
+    },
+    /** Value store for remember/compare across steps within a test case. */
+    valueStore: new Map(),
+};
+/**
+ * Initialize globals from CLI options. Call once at startup.
+ */
+export function initGlobals(opts) {
+    globals.debug = opts.debug;
+    globals.trace = opts.trace;
+}
+//# sourceMappingURL=globals.js.map

package/dist/globals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"globals.js","sourceRoot":"","sources":["../src/globals.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,CAAC,MAAM,OAAO,GAAG;IACtB,sCAAsC;IACtC,KAAK,EAAE,KAAK;IACZ,uFAAuF;IACvF,KAAK,EAAE;QACN,GAAG,KAAgB,CAAC;QACpB,YAAY,KAAgB,CAAC;QAC7B,cAAc,KAAgB,CAAC;KAChB;IAChB,wEAAwE;IACxE,UAAU,EAAE,IAAI,GAAG,EAAkB;CACrC,CAAA;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAG3B;IACA,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;IAC1B,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;AAC3B,CAAC"}

package/dist/parser/loader.d.ts

@@ -0,0 +1,7 @@
+import { type Suite } from "./schema.js";
+/**
+ * Load a suite YAML file: parse, validate, expand reusable steps, interpolate variables.
+ * Returns a fully resolved Suite ready for execution.
+ */
+export declare function loadSuite(filePath: string): Promise<Suite>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/parser/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/parser/loader.ts"],"names":[],"mappings":"AAEA,OAAO,EAAe,KAAK,KAAK,EAAiB,MAAM,aAAa,CAAA;AAGpE;;;GAGG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAkBhE"}

package/dist/parser/loader.js

@@ -0,0 +1,43 @@
+import { readFile } from "node:fs/promises";
+import { parse as parseYaml } from "yaml";
+import { SuiteSchema } from "./schema.js";
+import { interpolateSteps } from "./variables.js";
+/**
+ * Load a suite YAML file: parse, validate, expand reusable steps, interpolate variables.
+ * Returns a fully resolved Suite ready for execution.
+ */
+export async function loadSuite(filePath) {
+    const raw = await readFile(filePath, "utf-8");
+    const parsed = parseYaml(raw);
+    // Validate against schema
+    const suite = SuiteSchema.parse(parsed);
+    const variables = suite.variables ?? {};
+    const reusableSteps = suite.reusable_steps ?? {};
+    // Expand reusable steps and interpolate variables for each test case
+    const resolvedTests = suite.tests.map((test) => {
+        const expanded = expandReusableSteps(test.steps, reusableSteps);
+        const interpolated = interpolateSteps(expanded, variables);
+        return { ...test, steps: interpolated };
+    });
+    return { ...suite, tests: resolvedTests };
+}
+/**
+ * Expand reusable step references.
+ * If a step string exactly matches a reusable step name, replace it
+ * with that reusable step's list of steps (recursively).
+ */
+function expandReusableSteps(steps, reusableSteps) {
+    const result = [];
+    for (const step of steps) {
+        if (step in reusableSteps) {
+            // Recurse in case reusable steps reference other reusable steps
+            const expanded = expandReusableSteps(reusableSteps[step], reusableSteps);
+            result.push(...expanded);
+        }
+        else {
+            result.push(step);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=loader.js.map

package/dist/parser/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/parser/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAA;AACzC,OAAO,EAAE,WAAW,EAA6B,MAAM,aAAa,CAAA;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEjD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,QAAgB;IAC/C,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAC7C,MAAM,MAAM,GAAY,SAAS,CAAC,GAAG,CAAC,CAAA;IAEtC,0BAA0B;IAC1B,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAEvC,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,EAAE,CAAA;IACvC,MAAM,aAAa,GAAG,KAAK,CAAC,cAAc,IAAI,EAAE,CAAA;IAEhD,qEAAqE;IACrE,MAAM,aAAa,GAAe,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAC1D,MAAM,QAAQ,GAAG,mBAAmB,CAAC,IAAI,CAAC,KAAK,EAAE,aAAa,CAAC,CAAA;QAC/D,MAAM,YAAY,GAAG,gBAAgB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;QAC1D,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,CAAA;IACxC,CAAC,CAAC,CAAA;IAEF,OAAO,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,CAAA;AAC1C,CAAC;AAED;;;;GAIG;AACH,SAAS,mBAAmB,CAC3B,KAAe,EACf,aAAuC;IAEvC,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,IAAI,IAAI,aAAa,EAAE,CAAC;YAC3B,gEAAgE;YAChE,MAAM,QAAQ,GAAG,mBAAmB,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,CAAA;YACxE,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAA;QACzB,CAAC;aAAM,CAAC;YACP,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAClB,CAAC;IACF,CAAC;IACD,OAAO,MAAM,CAAA;AACd,CAAC"}

package/dist/parser/schema.d.ts

@@ -0,0 +1,42 @@
+import { z } from "zod";
+/** Viewport dimensions. */
+export declare const ViewportSchema: z.ZodObject<{
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+}, z.core.$strip>;
+/** A single test case: a name and ordered list of plain-English steps. */
+export declare const TestCaseSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    steps: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Top-level suite definition — matches the YAML format from the spec.
+ *
+ * reusable_steps is a map of name → step list.
+ * variables is a map of name → string value.
+ */
+export declare const SuiteSchema: z.ZodObject<{
+    suite: z.ZodString;
+    base_url: z.ZodOptional<z.ZodURL>;
+    viewport: z.ZodOptional<z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strip>>;
+    model: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        planner: z.ZodString;
+        pilot: z.ZodString;
+    }, z.core.$strip>]>>;
+    variables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    reusable_steps: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+    tests: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        steps: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** Inferred TypeScript types from the schemas. */
+export type Suite = z.infer<typeof SuiteSchema>;
+export type TestCase = z.infer<typeof TestCaseSchema>;
+export type Viewport = z.infer<typeof ViewportSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/parser/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/parser/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,2BAA2B;AAC3B,eAAO,MAAM,cAAc;;;iBAGzB,CAAA;AAEF,0EAA0E;AAC1E,eAAO,MAAM,cAAc;;;;iBAIzB,CAAA;AAEF;;;;;GAKG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;iBAatB,CAAA;AAEF,kDAAkD;AAClD,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAA;AAC/C,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AACrD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA"}