@plune-ai/cairn 0.2.1

package/dist/agent/index.js

@@ -0,0 +1,407 @@
+import { randomUUID } from "node:crypto";
+import { resolve, dirname, basename, join } from "node:path";
+import { readFile, readdir } from "node:fs/promises";
+import { makeGateway } from "../browser/index.js";
+import { makeModel } from "../llm/index.js";
+import { structuredInvoker, retryInvoke, CallBudget, cappedInvoke } from "../llm/structured.js";
+import { PromptRegistry } from "../prompts/index.js";
+import { initTelemetry } from "../telemetry/index.js";
+import { ArtifactStore } from "../artifacts/index.js";
+import { renderReportMd, locatorFor } from "../artifacts/report.js";
+import { renderTestCaseMd, parseTestCaseMd } from "../artifacts/testcase-md.js";
+import { automateCases } from "../codegen/index.js";
+import { deterministicScores } from "../eval/scorers.js";
+import { judgeTestCases, judgeChecklistCoverage } from "../eval/judge.js";
+import { pilotReview } from "../eval/pilot.js";
+import { collectPriorRuns, unionPassedTitles, formatExperience } from "../eval/collect.js";
+import { ingestChecklist, formatChecklist, coverageScore, styleDirective } from "../checklist/index.js";
+import { loadKnowledge } from "../knowledge/index.js";
+import { validateSuite } from "../validate/index.js";
+import { SessionStore, looksLikeLoginPage } from "../session/index.js";
+import { buildExploreGraph } from "./graph.js";
+export { buildExploreGraph, ExploreState } from "./graph.js";
+/**
+ * End-to-end exploration → methodological cases → runnable @playwright/test → validation/repair (MVP, Sprint 3).
+ * Artifacts land in runsBaseDir/<runId>/; everything is traced in Langfuse.
+ */
+export async function runExploration(input) {
+    const cfg = input.config;
+    const keys = { anthropicApiKey: cfg.anthropicApiKey, openrouterApiKey: cfg.openrouterApiKey };
+    const budget = new CallBudget(80); // cost-guardrail: safeguard (normally ~6-10 calls/run)
+    // Progress → live (CLI) + buffered into run.log.
+    const logLines = [];
+    const onProgress = (event) => {
+        logLines.push(`${new Date().toISOString()}  ${event}`);
+        input.onProgress?.(event);
+    };
+    // Auth: load storageState into the gateway (observe) and pass the path to the runner (validate).
+    let storageState;
+    let sessionPath;
+    const sessionStore = new SessionStore(resolve(input.sessionsDir ?? ".auth"));
+    if (input.sessionFile) {
+        sessionPath = resolve(input.sessionFile);
+        storageState = await sessionStore.loadFile(sessionPath);
+    }
+    else if (input.sessionName) {
+        sessionPath = sessionStore.pathFor(input.sessionName);
+        storageState = await sessionStore.loadFile(sessionPath);
+    }
+    const gateway = makeGateway({
+        backend: cfg.browser.backend,
+        storageState,
+        channel: cfg.browser.channel,
+        headless: !input.headed,
+    });
+    const telemetry = initTelemetry(cfg);
+    const prompts = new PromptRegistry();
+    const artifacts = new ArtifactStore(resolve(input.runsBaseDir ?? resolve(process.cwd(), "runs")));
+    const runId = randomUUID();
+    const runWriter = await artifacts.openRun(runId);
+    // Checklist (Sprint 4): a human narrows down WHAT to test → steers the design + measures coverage.
+    const checklistItems = input.checklistText ? ingestChecklist(input.checklistText) : [];
+    const checklistFormatted = formatChecklist(checklistItems);
+    const knowledgeText = await loadKnowledge(resolve(input.knowledgeDir ?? "knowledge"), input.url);
+    const experienceText = formatExperience(unionPassedTitles((await collectPriorRuns(resolve(input.runsBaseDir ?? resolve(process.cwd(), "runs")), input.url)).filter((r) => r.runId !== runId)));
+    const styleText = styleDirective(input.style ?? "all");
+    const languageText = input.language ?? cfg.testCaseLanguage;
+    const visionTier = cfg.models.vision ?? cfg.models.reasoning;
+    const graph = buildExploreGraph({
+        gateway,
+        prompts,
+        analyzeInvoke: cappedInvoke(retryInvoke(structuredInvoker(makeModel(visionTier, keys))), budget),
+        designInvoke: cappedInvoke(retryInvoke(structuredInvoker(makeModel(cfg.models.reasoning, keys))), budget),
+        codegenInvoke: cappedInvoke(retryInvoke(structuredInvoker(makeModel(cfg.models.bulk, keys))), budget),
+        useVision: visionTier.supportsVision,
+        checklistText: checklistFormatted,
+        knowledgeText,
+        experienceText,
+        styleText,
+        languageText,
+        runWriter,
+        validate: (runDir) => validateSuite(runDir, { storageStatePath: sessionPath }),
+        maxRepair: cfg.maxRepair,
+        onProgress,
+    });
+    try {
+        const out = await graph.invoke({ url: input.url, runId }, {
+            callbacks: telemetry.callbackHandler ? [telemetry.callbackHandler] : [],
+            runName: "exploration",
+            metadata: { runId, backend: cfg.browser.backend, profile: cfg.llmProfile },
+        });
+        if (!out.study || !out.analysis)
+            throw new Error("The graph did not return study/analysis.");
+        // Detect an expired session: a session was provided, but we ended up on the login page.
+        if (sessionPath &&
+            looksLikeLoginPage(out.analysis.pageSemantics, out.study.elements.map((e) => e.name ?? ""))) {
+            onProgress("⚠ looks like a redirect to LOGIN — the session is probably expired. Re-capture it: npm run session:save");
+        }
+        // keep-best: final = the BEST suite/validation across all attempts (repair could not make it worse).
+        const suite = out.bestSuite ?? out.suite;
+        const validation = out.bestValidation ?? out.validation;
+        if (out.bestSuite)
+            await runWriter.writeSuite(out.bestSuite); // restore the best code on disk
+        // Phase 4: study prior runs of this URL + collect the best (collect-best).
+        const runsBase = resolve(input.runsBaseDir ?? resolve(process.cwd(), "runs"));
+        const priorRuns = (await collectPriorRuns(runsBase, out.study.url)).filter((r) => r.runId !== runId);
+        const currentPassed = (validation?.results ?? [])
+            .filter((r) => r.status === "passed")
+            .map((r) => r.test);
+        const allTimePassing = unionPassedTitles([
+            ...priorRuns,
+            { runId, url: out.study.url, greenRatio: validation?.greenRatio ?? 0, passedTests: currentPassed },
+        ]);
+        const bestPriorGreen = priorRuns[0]?.greenRatio;
+        onProgress(`collect — prior runs for URL: ${priorRuns.length}` +
+            (bestPriorGreen !== undefined ? `; best so far: ${Math.round(bestPriorGreen * 100)}%` : "") +
+            `; stable cases total (all-time): ${allTimePassing.length}`);
+        // B1: run metrics — deterministic scorers + LLM-judge (SDK-side).
+        onProgress("score — scoring (scorers + LLM-judge)…");
+        const scores = deterministicScores({
+            study: out.study,
+            verified: out.verified,
+            testCases: out.testCases,
+            suite,
+            validation,
+        });
+        try {
+            scores.push(...(await judgeTestCases(out.testCases, out.analysis.pageSemantics, cappedInvoke(retryInvoke(structuredInvoker(makeModel(cfg.models.judge, keys))), budget), prompts)));
+        }
+        catch {
+            // the judge is not critical for the run
+        }
+        if (checklistItems.length > 0) {
+            try {
+                const cov = await judgeChecklistCoverage(checklistItems, out.testCases, cappedInvoke(retryInvoke(structuredInvoker(makeModel(cfg.models.judge, keys))), budget), prompts);
+                scores.push({ name: "checklist_coverage", value: cov.value, comment: cov.comment });
+            }
+            catch {
+                // fallback: token-based coverage (offline / judge unavailable)
+                scores.push({ name: "checklist_coverage", value: coverageScore(checklistItems, out.testCases) });
+            }
+        }
+        onProgress(`score — ${scores.length} metrics`);
+        // Best-effort: write scores to Langfuse against the trace (requires a self-hosted instance).
+        const traceId = telemetry.callbackHandler?.last_trace_id;
+        if (telemetry.enabled && telemetry.client && traceId) {
+            try {
+                for (const sc of scores) {
+                    telemetry.client.score.create({
+                        traceId,
+                        name: sc.name,
+                        value: sc.value,
+                        comment: sc.comment,
+                        dataType: "NUMERIC",
+                    });
+                }
+            }
+            catch {
+                // best-effort
+            }
+        }
+        // Pilot supervisor: a holistic verdict for the run (idea from explorbot).
+        let pilot;
+        try {
+            pilot = await pilotReview(out.analysis.pageSemantics, validation, out.testCases, cappedInvoke(retryInvoke(structuredInvoker(makeModel(cfg.models.judge, keys))), budget), prompts);
+            onProgress(`pilot — verdict: ${pilot.verdict} — ${pilot.reason}`);
+        }
+        catch {
+            // pilot is not critical
+        }
+        await runWriter.writeStudy(out.study);
+        if (out.study.screenshotB64)
+            await runWriter.writeScreenshot(out.study.screenshotB64);
+        await runWriter.writeAria(out.study.ariaYaml);
+        await runWriter.writeReport({
+            runId,
+            url: out.study.url,
+            pageSemantics: out.analysis.pageSemantics,
+            testCases: out.testCases,
+            validation,
+            scores,
+            pilot,
+            history: {
+                priorRuns: priorRuns.length,
+                bestPriorGreen: bestPriorGreen ?? null,
+                allTimePassing,
+            },
+        });
+        await runWriter.writeReportMd(renderReportMd({
+            runId,
+            url: out.study.url,
+            backend: cfg.browser.backend,
+            profile: cfg.llmProfile,
+            pageSemantics: out.analysis.pageSemantics,
+            elements: out.study.elements,
+            testCases: out.testCases,
+            validation,
+            scores,
+            consoleErrors: out.study.consoleErrors,
+        }));
+        const green = validation ? `${Math.round(validation.greenRatio * 100)}%` : "—";
+        await runWriter.writeLog([...logLines, "", `summary: green=${green} testCases=${out.testCases.length} runId=${runId}`].join("\n"));
+        return {
+            runId,
+            runDir: runWriter.dir,
+            study: out.study,
+            analysis: out.analysis,
+            testCases: out.testCases,
+            suite,
+            validation,
+            scores,
+            pilot,
+        };
+    }
+    finally {
+        await gateway.close();
+        await telemetry.shutdown();
+    }
+}
+function suiteFromUrl(url) {
+    try {
+        const seg = new URL(url).pathname.split("/").filter(Boolean).pop() ?? "page";
+        return `${seg.replace(/[^a-z0-9]+/gi, "-").toUpperCase()}-UI`;
+    }
+    catch {
+        return "PAGE-UI";
+    }
+}
+/**
+ * Design-only flow (Sprint: decoupled workflow): explore the page (observe+verify+multi-state+probe),
+ * WRITE test cases in the user's format (testcases/ATC-*.md with selectors), WITHOUT codegen/validate.
+ * Automation is a separate `automate` command.
+ */
+export async function runDesign(input) {
+    const cfg = input.config;
+    const keys = { anthropicApiKey: cfg.anthropicApiKey, openrouterApiKey: cfg.openrouterApiKey };
+    const budget = new CallBudget(80); // cost-guardrail: safeguard (normally ~6-10 calls/run)
+    const logLines = [];
+    const onProgress = (event) => {
+        logLines.push(`${new Date().toISOString()}  ${event}`);
+        input.onProgress?.(event);
+    };
+    let storageState;
+    const sessionStore = new SessionStore(resolve(input.sessionsDir ?? ".auth"));
+    if (input.sessionFile)
+        storageState = await sessionStore.loadFile(resolve(input.sessionFile));
+    else if (input.sessionName)
+        storageState = await sessionStore.loadFile(sessionStore.pathFor(input.sessionName));
+    const gateway = makeGateway({
+        backend: cfg.browser.backend,
+        storageState,
+        channel: cfg.browser.channel,
+        headless: !input.headed,
+    });
+    const telemetry = initTelemetry(cfg);
+    const prompts = new PromptRegistry();
+    const artifacts = new ArtifactStore(resolve(input.runsBaseDir ?? resolve(process.cwd(), "runs")));
+    const runId = randomUUID();
+    const runWriter = await artifacts.openRun(runId);
+    const checklistItems = input.checklistText ? ingestChecklist(input.checklistText) : [];
+    const knowledgeText = await loadKnowledge(resolve(input.knowledgeDir ?? "knowledge"), input.url);
+    const experienceText = formatExperience(unionPassedTitles((await collectPriorRuns(resolve(input.runsBaseDir ?? resolve(process.cwd(), "runs")), input.url)).filter((r) => r.runId !== runId)));
+    const styleText = styleDirective(input.style ?? "all");
+    const languageText = input.language ?? cfg.testCaseLanguage;
+    const visionTier = cfg.models.vision ?? cfg.models.reasoning;
+    const graph = buildExploreGraph({
+        gateway,
+        prompts,
+        analyzeInvoke: cappedInvoke(retryInvoke(structuredInvoker(makeModel(visionTier, keys))), budget),
+        designInvoke: cappedInvoke(retryInvoke(structuredInvoker(makeModel(cfg.models.reasoning, keys))), budget),
+        codegenInvoke: cappedInvoke(retryInvoke(structuredInvoker(makeModel(cfg.models.bulk, keys))), budget),
+        useVision: visionTier.supportsVision,
+        checklistText: formatChecklist(checklistItems),
+        knowledgeText,
+        experienceText,
+        styleText,
+        languageText,
+        runWriter,
+        validate: () => Promise.resolve({ results: [], greenRatio: 0, flakyCount: 0 }),
+        maxRepair: 0,
+        onProgress,
+        codeless: true,
+    });
+    try {
+        const out = await graph.invoke({ url: input.url, runId }, {
+            callbacks: telemetry.callbackHandler ? [telemetry.callbackHandler] : [],
+            runName: "design",
+            metadata: { runId, backend: cfg.browser.backend, profile: cfg.llmProfile, mode: "design" },
+        });
+        if (!out.study || !out.analysis)
+            throw new Error("The graph did not return study/analysis.");
+        if ((input.sessionName || input.sessionFile) &&
+            looksLikeLoginPage(out.analysis.pageSemantics, out.study.elements.map((e) => e.name ?? ""))) {
+            onProgress("⚠ looks like a redirect to LOGIN — the session is expired. Re-capture it: npm run session:save");
+        }
+        const suite = suiteFromUrl(out.study.url);
+        const verifiedByRef = new Map(out.verified.map((v) => [v.ref, v]));
+        let autoN = 0;
+        let manualN = 0;
+        const docs = out.testCases.map((tc) => {
+            const manual = tc.execution === "manual";
+            const n = manual ? (manualN += 1) : (autoN += 1);
+            const id = `${manual ? "MTC" : "ATC"}-${suite}-${String(n).padStart(3, "0")}`;
+            const automationPath = manual
+                ? "— (manual, not automated)"
+                : `tests/ui/${suite.toLowerCase()}/${id.toLowerCase()}.spec.ts`;
+            const status = manual ? "📋 Manual" : "❌ Not implemented";
+            const selectors = tc.elementRefs
+                .map((r) => verifiedByRef.get(r))
+                .filter((v) => Boolean(v))
+                .map((v) => ({ label: v.name ?? v.role, locator: locatorFor(v) }));
+            const traceability = checklistItems.length > 0 ? [{ source: "Checklist", reference: "provided plan" }] : [];
+            const doc = { id, suite, status, automationPath, selectors, traceability };
+            return { id, md: renderTestCaseMd(tc, doc) };
+        });
+        const testCaseFiles = await runWriter.writeTestCases(docs);
+        onProgress(`design — wrote ${testCaseFiles.length} cases: ${autoN} auto/ATC, ${manualN} manual/MTC (${suite}) → testcases/`);
+        const scores = deterministicScores({
+            study: out.study,
+            verified: out.verified,
+            testCases: out.testCases,
+        });
+        try {
+            scores.push(...(await judgeTestCases(out.testCases, out.analysis.pageSemantics, cappedInvoke(retryInvoke(structuredInvoker(makeModel(cfg.models.judge, keys))), budget), prompts)));
+        }
+        catch {
+            // judge optional
+        }
+        if (checklistItems.length > 0) {
+            try {
+                const cov = await judgeChecklistCoverage(checklistItems, out.testCases, cappedInvoke(retryInvoke(structuredInvoker(makeModel(cfg.models.judge, keys))), budget), prompts);
+                scores.push({ name: "checklist_coverage", value: cov.value, comment: cov.comment });
+            }
+            catch {
+                scores.push({ name: "checklist_coverage", value: coverageScore(checklistItems, out.testCases) });
+            }
+        }
+        await runWriter.writeStudy(out.study);
+        if (out.study.screenshotB64)
+            await runWriter.writeScreenshot(out.study.screenshotB64);
+        await runWriter.writeAria(out.study.ariaYaml);
+        await runWriter.writeReport({
+            runId,
+            url: out.study.url,
+            mode: "design",
+            suite,
+            pageSemantics: out.analysis.pageSemantics,
+            testCases: out.testCases,
+            testCaseFiles,
+            scores,
+        });
+        await runWriter.writeLog([...logLines, "", `summary: mode=design testCases=${out.testCases.length} suite=${suite} runId=${runId}`].join("\n"));
+        return {
+            runId,
+            runDir: runWriter.dir,
+            study: out.study,
+            analysis: out.analysis,
+            testCases: out.testCases,
+            testCaseFiles,
+            scores,
+        };
+    }
+    finally {
+        await gateway.close();
+        await telemetry.shutdown();
+    }
+}
+/**
+ * `automate` command: from ready cases (runDir/testcases/*.md) → @playwright/test code in runDir/tests/.
+ * The second half of the decoupled flow (design → automate). Optionally validates (requires a session).
+ */
+export async function runAutomate(input) {
+    const cfg = input.config;
+    const keys = { anthropicApiKey: cfg.anthropicApiKey, openrouterApiKey: cfg.openrouterApiKey };
+    const budget = new CallBudget(80); // cost-guardrail: safeguard (normally ~6-10 calls/run)
+    const onProgress = input.onProgress ?? (() => undefined);
+    const runDir = resolve(input.runDir);
+    const rep = JSON.parse(await readFile(join(runDir, "report.json"), "utf8"));
+    const baseUrl = rep.url ?? "";
+    const pageSemantics = rep.pageSemantics ?? "";
+    const tcDir = join(runDir, "testcases");
+    const mdFiles = (await readdir(tcDir)).filter((f) => f.endsWith(".md"));
+    const allCases = [];
+    for (const f of mdFiles)
+        allCases.push(parseTestCaseMd(await readFile(join(tcDir, f), "utf8")));
+    // Only auto/ATC — manual/MTC cases are NOT automated (they are manual).
+    const cases = allCases.filter((c) => c.execution !== "manual" && !c.id.startsWith("MTC"));
+    const skipped = allCases.length - cases.length;
+    onProgress(`automate — ${cases.length} auto cases (skipped manual/MTC: ${skipped}) from ${tcDir}`);
+    const suite = await automateCases(cases, { baseUrl, pageSemantics }, { invoke: cappedInvoke(retryInvoke(structuredInvoker(makeModel(cfg.models.bulk, keys))), budget), prompts: new PromptRegistry() });
+    const artifacts = new ArtifactStore(dirname(runDir));
+    const runWriter = await artifacts.openRun(basename(runDir));
+    const specFiles = await runWriter.writeSuite(suite);
+    onProgress(`automate — generated ${specFiles.length} spec files → tests/`);
+    let validation;
+    if (input.validate) {
+        let sessionPath;
+        if (input.sessionFile)
+            sessionPath = resolve(input.sessionFile);
+        else if (input.sessionName) {
+            sessionPath = new SessionStore(resolve(input.sessionsDir ?? ".auth")).pathFor(input.sessionName);
+        }
+        validation = await validateSuite(runWriter.dir, { storageStatePath: sessionPath });
+        onProgress(`automate — validation: ${Math.round(validation.greenRatio * 100)}% green`);
+    }
+    return { runDir: runWriter.dir, specFiles, validation };
+}
+//# sourceMappingURL=index.js.map

package/dist/agent/index.js.map

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

package/dist/analyze/index.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+import type { StructuredInvoke } from "../llm/structured.js";
+import type { PromptRegistry } from "../prompts/index.js";
+import type { PageStudy } from "../observe/index.js";
+export declare const PageAnalysisSchema: z.ZodObject<{
+    pageSemantics: z.ZodString;
+    primaryRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    viewSwitchers: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type PageAnalysis = z.infer<typeof PageAnalysisSchema>;
+export interface AnalyzeDeps {
+    invoke: StructuredInvoke;
+    prompts: PromptRegistry;
+    /** Send the screenshot (vision). If false or the model has no vision — aria-only mode (ADR-0002). */
+    vision?: boolean;
+}
+/**
+ * Page analysis (identifyElements node): page purpose + the most important refs.
+ * Grounding: primaryRefs are filtered to those actually present (anti-hallucination).
+ */
+export declare function analyzePage(study: PageStudy, deps: AnalyzeDeps): Promise<PageAnalysis>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analyze/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGrD,eAAO,MAAM,kBAAkB;;;;iBAK7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,EAAE,cAAc,CAAC;IACxB,qGAAqG;IACrG,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CA0B5F"}

package/dist/analyze/index.js

@@ -0,0 +1,39 @@
+import { HumanMessage } from "@langchain/core/messages";
+import { z } from "zod";
+import { imageBlock } from "../llm/index.js";
+export const PageAnalysisSchema = z.object({
+    pageSemantics: z.string(),
+    primaryRefs: z.array(z.string()).default([]),
+    /** Refs of view/tab/wizard-step switchers (a click opens different content). */
+    viewSwitchers: z.array(z.string()).default([]),
+});
+/**
+ * Page analysis (identifyElements node): page purpose + the most important refs.
+ * Grounding: primaryRefs are filtered to those actually present (anti-hallucination).
+ */
+export async function analyzePage(study, deps) {
+    const elements = study.elements
+        .map((e) => `${e.ref} · ${e.role}${e.name ? ` "${e.name}"` : ""}`)
+        .join("\n");
+    const prompt = await deps.prompts.getPrompt("identify-elements", {
+        ariaYaml: study.ariaYaml,
+        elements,
+    });
+    const useVision = Boolean(deps.vision && study.screenshotB64);
+    const message = useVision
+        ? new HumanMessage({
+            content: [
+                { type: "text", text: prompt.text },
+                imageBlock(study.screenshotB64, "image/png"),
+            ],
+        })
+        : new HumanMessage(prompt.text);
+    const raw = await deps.invoke(PageAnalysisSchema, [message]);
+    const known = new Set(study.elements.map((e) => e.ref));
+    return {
+        pageSemantics: raw.pageSemantics,
+        primaryRefs: raw.primaryRefs.filter((r) => known.has(r)),
+        viewSwitchers: raw.viewSwitchers.filter((r) => known.has(r)),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/analyze/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/analyze/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;IACzB,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC5C,gFAAgF;IAChF,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAC/C,CAAC,CAAC;AAUH;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAgB,EAAE,IAAiB;IACnE,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ;SAC5B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;SACjE,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,mBAAmB,EAAE;QAC/D,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ;KACT,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,SAAS;QACvB,CAAC,CAAC,IAAI,YAAY,CAAC;YACf,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE;gBACnC,UAAU,CAAC,KAAK,CAAC,aAAa,EAAE,WAAW,CAAC;aAC7C;SACF,CAAC;QACJ,CAAC,CAAC,IAAI,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAElC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACxD,OAAO;QACL,aAAa,EAAE,GAAG,CAAC,aAAa;QAChC,WAAW,EAAE,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACxD,aAAa,EAAE,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;KAC7D,CAAC;AACJ,CAAC"}

package/dist/artifacts/index.d.ts

@@ -0,0 +1,29 @@
+import type { PageStudy } from "../observe/index.js";
+import type { GeneratedSuite } from "../codegen/index.js";
+export interface RunWriter {
+    runId: string;
+    dir: string;
+    writeStudy(study: PageStudy): Promise<void>;
+    /** Writes spec files to tests/; returns the absolute paths written. Blocks traversal. */
+    writeSuite(suite: GeneratedSuite): Promise<string[]>;
+    writeReport(report: unknown): Promise<void>;
+    writeScreenshot(b64: string): Promise<void>;
+    /** ARIA snapshot as a separate readable file (snapshots/aria.yaml). */
+    writeAria(yaml: string): Promise<void>;
+    /** Human-readable Markdown report with selectors (report.md). */
+    writeReportMd(md: string): Promise<void>;
+    /** Run log (run.log). */
+    writeLog(text: string): Promise<void>;
+    /** Test cases in the user's format → testcases/<id>.md; returns the paths. */
+    writeTestCases(docs: {
+        id: string;
+        md: string;
+    }[]): Promise<string[]>;
+}
+/** Local trail of each run: runs/<id>/ (study, tests, snapshots, report). */
+export declare class ArtifactStore {
+    private readonly baseDir;
+    constructor(baseDir: string);
+    openRun(runId: string): Promise<RunWriter>;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/artifacts/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,yFAAyF;IACzF,UAAU,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACrD,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,uEAAuE;IACvE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,iEAAiE;IACjE,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,yBAAyB;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,8EAA8E;IAC9E,cAAc,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACvE;AAED,6EAA6E;AAC7E,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,MAAM;IAEtC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;CA0DjD"}

package/dist/artifacts/index.js

@@ -0,0 +1,68 @@
+import { mkdir, rm, writeFile } from "node:fs/promises";
+import { dirname, isAbsolute, join, relative, resolve } from "node:path";
+/** Local trail of each run: runs/<id>/ (study, tests, snapshots, report). */
+export class ArtifactStore {
+    baseDir;
+    constructor(baseDir) {
+        this.baseDir = baseDir;
+    }
+    async openRun(runId) {
+        const dir = resolve(this.baseDir, runId);
+        const testsDir = join(dir, "tests");
+        await mkdir(testsDir, { recursive: true });
+        return {
+            runId,
+            dir,
+            writeStudy: async (study) => {
+                await writeFile(join(dir, "study.json"), JSON.stringify(study, null, 2), "utf8");
+            },
+            writeSuite: async (suite) => {
+                // Clean start: every generation (including repair) fully overwrites tests/.
+                await rm(testsDir, { recursive: true, force: true });
+                await mkdir(testsDir, { recursive: true });
+                const out = [];
+                for (const f of suite.files) {
+                    const target = resolve(testsDir, f.path);
+                    const rel = relative(testsDir, target);
+                    if (rel.startsWith("..") || isAbsolute(rel))
+                        continue; // traversal — skip
+                    await mkdir(dirname(target), { recursive: true });
+                    await writeFile(target, f.content, "utf8");
+                    out.push(target);
+                }
+                return out;
+            },
+            writeReport: async (report) => {
+                await writeFile(join(dir, "report.json"), JSON.stringify(report, null, 2), "utf8");
+            },
+            writeScreenshot: async (b64) => {
+                const snaps = join(dir, "snapshots");
+                await mkdir(snaps, { recursive: true });
+                await writeFile(join(snaps, "screenshot.png"), Buffer.from(b64, "base64"));
+            },
+            writeAria: async (yaml) => {
+                const snaps = join(dir, "snapshots");
+                await mkdir(snaps, { recursive: true });
+                await writeFile(join(snaps, "aria.yaml"), yaml, "utf8");
+            },
+            writeReportMd: async (md) => {
+                await writeFile(join(dir, "report.md"), md, "utf8");
+            },
+            writeLog: async (text) => {
+                await writeFile(join(dir, "run.log"), text, "utf8");
+            },
+            writeTestCases: async (docs) => {
+                const tcDir = join(dir, "testcases");
+                await mkdir(tcDir, { recursive: true });
+                const out = [];
+                for (const d of docs) {
+                    const p = join(tcDir, `${d.id}.md`);
+                    await writeFile(p, d.md, "utf8");
+                    out.push(p);
+                }
+                return out;
+            },
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/artifacts/index.js.map

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

package/dist/artifacts/report.d.ts

@@ -0,0 +1,21 @@
+import type { ElementRef } from "../browser/types.js";
+import type { TestCase } from "../design/index.js";
+import type { ValidationReport } from "../validate/index.js";
+import type { Score } from "../eval/scorers.js";
+/** Generate a Playwright locator for an element (ref → getByRole). */
+export declare function locatorFor(el: ElementRef): string;
+export interface ReportInput {
+    runId: string;
+    url: string;
+    backend: string;
+    profile: string;
+    pageSemantics: string;
+    elements: ElementRef[];
+    testCases: TestCase[];
+    validation?: ValidationReport;
+    scores?: Score[];
+    consoleErrors?: string[];
+}
+/** Human-readable Markdown run report: semantics, elements+selectors, cases, validation. */
+export declare function renderReportMd(r: ReportInput): string;
+//# sourceMappingURL=report.d.ts.map