@plune-ai/cairn 0.2.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/artifacts/report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEhD,sEAAsE;AACtE,wBAAgB,UAAU,CAAC,EAAE,EAAE,UAAU,GAAG,MAAM,CAGjD;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAMD,4FAA4F;AAC5F,wBAAgB,cAAc,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CA+CrD"}

package/dist/artifacts/report.js

@@ -0,0 +1,56 @@
+/** Generate a Playwright locator for an element (ref → getByRole). */
+export function locatorFor(el) {
+    const name = el.name ? `, { name: '${el.name.replace(/'/g, "\\'")}' }` : "";
+    return `page.getByRole('${el.role}'${name})`;
+}
+function mark(status) {
+    return status === "passed" ? "✓" : status === "flaky" ? "~" : "✗";
+}
+/** Human-readable Markdown run report: semantics, elements+selectors, cases, validation. */
+export function renderReportMd(r) {
+    const lines = ["# QA Explorer — run report", ""];
+    lines.push(`- **URL:** ${r.url}`);
+    lines.push(`- **Run ID:** ${r.runId}`);
+    lines.push(`- **Backend:** ${r.backend} · **Profile:** ${r.profile}`);
+    lines.push(`- **Purpose:** ${r.pageSemantics}`);
+    if (r.validation) {
+        lines.push(`- **Validation:** ${Math.round(r.validation.greenRatio * 100)}% green (flaky: ${r.validation.flakyCount})`);
+    }
+    lines.push("");
+    if (r.scores && r.scores.length > 0) {
+        lines.push("## Metrics (scores)", "", "| metric | value |", "|---|---|");
+        for (const s of r.scores) {
+            lines.push(`| ${s.name} | ${s.value.toFixed(2)}${s.comment ? ` — ${s.comment}` : ""} |`);
+        }
+        lines.push("");
+    }
+    if (r.consoleErrors && r.consoleErrors.length > 0) {
+        lines.push(`## Page JS errors (${r.consoleErrors.length})`, "");
+        for (const e of r.consoleErrors.slice(0, 20))
+            lines.push(`- ${e}`);
+        lines.push("");
+    }
+    const interactive = r.elements.filter((e) => e.interactive);
+    lines.push(`## Interactive elements (${interactive.length})`, "");
+    lines.push("| ref | role | name | Playwright locator |", "|---|---|---|---|");
+    for (const e of interactive) {
+        lines.push(`| ${e.ref} | ${e.role} | ${e.name ?? ""} | \`${locatorFor(e)}\` |`);
+    }
+    lines.push("");
+    lines.push(`## Test cases (${r.testCases.length})`, "");
+    const statusByTitle = new Map((r.validation?.results ?? []).map((x) => [x.test, x.status]));
+    for (const tc of r.testCases) {
+        const st = statusByTitle.get(tc.title);
+        lines.push(`### ${tc.id} · [${tc.priority} · ${tc.technique}] ${tc.title}${st ? ` — ${mark(st)}` : ""}`);
+        if (tc.preconditions.length)
+            lines.push(`- Preconditions: ${tc.preconditions.join("; ")}`);
+        for (const s of tc.steps)
+            lines.push(`- ${s}`);
+        lines.push(`- ⇒ ${tc.expected}`);
+        if (tc.elementRefs.length)
+            lines.push(`- refs: ${tc.elementRefs.join(", ")}`);
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=report.js.map

package/dist/artifacts/report.js.map

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

package/dist/artifacts/testcase-md.d.ts

@@ -0,0 +1,37 @@
+import type { TestCase } from "../design/index.js";
+/** Context for rendering a single case into the user's ATC format. */
+export interface TestCaseDoc {
+    id: string;
+    suite: string;
+    status: string;
+    automationPath: string;
+    selectors: {
+        label: string;
+        locator: string;
+    }[];
+    traceability: {
+        source: string;
+        reference: string;
+    }[];
+}
+/** Our priority → P1/P2/P3 (user's format). */
+export declare function mapPriority(p: TestCase["priority"]): string;
+/** ASCII slug for file names / automation paths. */
+export declare function slugify(s: string): string;
+/** Render a test case into ATC markdown (frontmatter + Preconditions/Steps/Expected/Selectors/Traceability). */
+export declare function renderTestCaseMd(tc: TestCase, doc: TestCaseDoc): string;
+/** A parsed test case (for the automate command). */
+export interface ParsedTestCase {
+    id: string;
+    execution: string;
+    title: string;
+    steps: string[];
+    expected: string[];
+    selectors: {
+        label: string;
+        locator: string;
+    }[];
+}
+/** Parse ATC markdown back into a structure (for automate: .md → code). */
+export declare function parseTestCaseMd(md: string): ParsedTestCase;
+//# sourceMappingURL=testcase-md.d.ts.map

package/dist/artifacts/testcase-md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testcase-md.d.ts","sourceRoot":"","sources":["../../src/artifacts/testcase-md.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,sEAAsE;AACtE,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAChD,YAAY,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACvD;AAED,+CAA+C;AAC/C,wBAAgB,WAAW,CAAC,CAAC,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,MAAM,CAE3D;AAED,oDAAoD;AACpD,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAMzC;AAED,gHAAgH;AAChH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,WAAW,GAAG,MAAM,CA2CvE;AAED,qDAAqD;AACrD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACjD;AAOD,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,CA4B1D"}

package/dist/artifacts/testcase-md.js

@@ -0,0 +1,91 @@
+/** Our priority → P1/P2/P3 (user's format). */
+export function mapPriority(p) {
+    return p === "critical" || p === "high" ? "P1" : p === "medium" ? "P2" : "P3";
+}
+/** ASCII slug for file names / automation paths. */
+export function slugify(s) {
+    const ascii = s
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return ascii.length > 0 ? ascii.slice(0, 60) : "test";
+}
+/** Render a test case into ATC markdown (frontmatter + Preconditions/Steps/Expected/Selectors/Traceability). */
+export function renderTestCaseMd(tc, doc) {
+    const lines = [];
+    lines.push("---");
+    lines.push(`id: ${doc.id}`);
+    lines.push(`title: "${tc.title.replace(/"/g, "'")}"`);
+    lines.push(`suite: ${doc.suite}`);
+    lines.push(`priority: ${mapPriority(tc.priority)}`);
+    lines.push(`type: ${tc.type}`);
+    lines.push(`execution: ${tc.execution}`);
+    lines.push(`status: ${doc.status}`);
+    lines.push(`automation: ${doc.automationPath}`);
+    lines.push("---", "");
+    lines.push(`# ${doc.id}: ${tc.title}`, "");
+    lines.push("## Preconditions", "");
+    if (tc.preconditions.length > 0)
+        for (const p of tc.preconditions)
+            lines.push(`- ${p}`);
+    else
+        lines.push("- (none)");
+    lines.push("");
+    lines.push("## Steps", "");
+    const steps = tc.steps.length > 0 ? tc.steps : ["Open the page"];
+    steps.forEach((s, i) => lines.push(`${i + 1}. ${s}`));
+    lines.push("");
+    lines.push("## Expected Result", "");
+    lines.push(`- ${tc.expected}`);
+    lines.push("");
+    if (doc.selectors.length > 0) {
+        lines.push("## Selectors (recorded during exploration)", "");
+        lines.push("| Element | Locator |", "| --- | --- |");
+        for (const s of doc.selectors)
+            lines.push(`| ${s.label} | \`${s.locator}\` |`);
+        lines.push("");
+    }
+    if (doc.traceability.length > 0) {
+        lines.push("## Traceability", "");
+        lines.push("| Source | Reference |", "| --- | --- |");
+        for (const t of doc.traceability)
+            lines.push(`| ${t.source} | ${t.reference} |`);
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+function section(md, name) {
+    const re = new RegExp(`##\\s+${name}[^\\n]*\\n([\\s\\S]*?)(?=\\n##\\s|$)`, "i");
+    return md.match(re)?.[1] ?? "";
+}
+/** Parse ATC markdown back into a structure (for automate: .md → code). */
+export function parseTestCaseMd(md) {
+    const id = md.match(/^id:\s*(.+?)\s*$/m)?.[1]?.trim() ?? "";
+    const execution = md.match(/^execution:\s*(.+?)\s*$/m)?.[1]?.trim() ?? "auto";
+    const titleM = md.match(/^title:\s*"?(.+?)"?\s*$/m);
+    const title = (titleM?.[1] ?? md.match(/^#\s+[^:\n]*:\s*(.+)$/m)?.[1] ?? "Untitled").trim();
+    const steps = section(md, "Steps")
+        .split(/\r?\n/)
+        .map((l) => l.trim())
+        .filter((l) => /^\d+\.\s/.test(l))
+        .map((l) => l.replace(/^\d+\.\s*/, ""));
+    const expected = section(md, "Expected Result")
+        .split(/\r?\n/)
+        .map((l) => l.trim())
+        .filter((l) => l.startsWith("- "))
+        .map((l) => l.slice(2).trim());
+    const selectors = section(md, "Selectors")
+        .split(/\r?\n/)
+        .map((l) => l.trim())
+        .filter((l) => l.startsWith("|") && !l.includes("---") && !/Element|Locator/i.test(l))
+        .map((l) => {
+        const cells = l
+            .split("|")
+            .map((c) => c.trim())
+            .filter((c) => c.length > 0);
+        return { label: cells[0] ?? "", locator: (cells[1] ?? "").replace(/`/g, "").trim() };
+    })
+        .filter((s) => s.locator.length > 0);
+    return { id, execution, title, steps, expected, selectors };
+}
+//# sourceMappingURL=testcase-md.js.map

package/dist/artifacts/testcase-md.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testcase-md.js","sourceRoot":"","sources":["../../src/artifacts/testcase-md.ts"],"names":[],"mappings":"AAYA,+CAA+C;AAC/C,MAAM,UAAU,WAAW,CAAC,CAAuB;IACjD,OAAO,CAAC,KAAK,UAAU,IAAI,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAChF,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,OAAO,CAAC,CAAS;IAC/B,MAAM,KAAK,GAAG,CAAC;SACZ,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC3B,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AACxD,CAAC;AAED,gHAAgH;AAChH,MAAM,UAAU,gBAAgB,CAAC,EAAY,EAAE,GAAgB;IAC7D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;IAC5B,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IACtD,KAAK,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,CAAC,aAAa,WAAW,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACpD,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/B,KAAK,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC;IACzC,KAAK,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IACpC,KAAK,CAAC,IAAI,CAAC,eAAe,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACtB,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IAE3C,KAAK,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;IACnC,IAAI,EAAE,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,aAAa;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;;QACnF,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC5B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC3B,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;IACjE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IACtD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;IACrC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC/B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,IAAI,GAAG,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,4CAA4C,EAAE,EAAE,CAAC,CAAC;QAC7D,KAAK,CAAC,IAAI,CAAC,uBAAuB,EAAE,eAAe,CAAC,CAAC;QACrD,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,OAAO,MAAM,CAAC,CAAC;QAC/E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,GAAG,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,wBAAwB,EAAE,eAAe,CAAC,CAAC;QACtD,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,YAAY;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC;QACjF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAYD,SAAS,OAAO,CAAC,EAAU,EAAE,IAAY;IACvC,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,SAAS,IAAI,sCAAsC,EAAE,GAAG,CAAC,CAAC;IAChF,OAAO,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACjC,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,eAAe,CAAC,EAAU;IACxC,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC5D,MAAM,SAAS,GAAG,EAAE,CAAC,KAAK,CAAC,0BAA0B,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,MAAM,CAAC;IAC9E,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,wBAAwB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5F,MAAM,KAAK,GAAG,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC;SAC/B,KAAK,CAAC,OAAO,CAAC;SACd,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;SACjC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,OAAO,CAAC,EAAE,EAAE,iBAAiB,CAAC;SAC5C,KAAK,CAAC,OAAO,CAAC;SACd,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;SACjC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACjC,MAAM,SAAS,GAAG,OAAO,CAAC,EAAE,EAAE,WAAW,CAAC;SACvC,KAAK,CAAC,OAAO,CAAC;SACd,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;SACrF,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,KAAK,GAAG,CAAC;aACZ,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC/B,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;IACvF,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACvC,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;AAC9D,CAAC"}

package/dist/browser/backends/playwright-cli.d.ts

@@ -0,0 +1,23 @@
+import type { BrowserBackend } from "../gateway.js";
+import type { ActResult, Action, Observation, ObserveOptions } from "../types.js";
+export interface PlaywrightCliOptions {
+    session?: string;
+}
+/**
+ * SECONDARY backend (ADR-0003): a wrapper over `@playwright/cli` (stateful MCP-CLI, headless by default).
+ * Token-efficient observe/act. Does NOT own session/runTests — those come from lib (hence not implemented here).
+ *
+ * Spike S3 limitations: the `file:` protocol is blocked (an http origin is required); each command is a separate
+ * node→daemon process; the snapshot yields native refs `[ref=eN]`, which parseAriaSnapshot uses directly.
+ */
+export declare class PlaywrightCliBackend implements BrowserBackend {
+    private readonly sessionName;
+    private opened;
+    constructor(opts?: PlaywrightCliOptions);
+    private run;
+    private ensureUrl;
+    observe(opts: ObserveOptions): Promise<Observation>;
+    act(action: Action): Promise<ActResult>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=playwright-cli.d.ts.map

package/dist/browser/backends/playwright-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright-cli.d.ts","sourceRoot":"","sources":["../../../src/browser/backends/playwright-cli.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAOlF,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,qBAAa,oBAAqB,YAAW,cAAc;IACzD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,MAAM,CAAS;gBAEX,IAAI,GAAE,oBAAyB;YAI7B,GAAG;YAOH,SAAS;IAajB,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC;IAmBnD,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAevC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAM7B"}

package/dist/browser/backends/playwright-cli.js

@@ -0,0 +1,85 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { createRequire } from "node:module";
+import { mkdtemp, readFile, unlink } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { dirname, join } from "node:path";
+const execFileAsync = promisify(execFile);
+const require = createRequire(import.meta.url);
+/** Path to the @playwright/cli bin (resolved via the package's package.json). */
+const CLI_JS = join(dirname(require.resolve("@playwright/cli/package.json")), "playwright-cli.js");
+/**
+ * SECONDARY backend (ADR-0003): a wrapper over `@playwright/cli` (stateful MCP-CLI, headless by default).
+ * Token-efficient observe/act. Does NOT own session/runTests — those come from lib (hence not implemented here).
+ *
+ * Spike S3 limitations: the `file:` protocol is blocked (an http origin is required); each command is a separate
+ * node→daemon process; the snapshot yields native refs `[ref=eN]`, which parseAriaSnapshot uses directly.
+ */
+export class PlaywrightCliBackend {
+    sessionName;
+    opened = false;
+    constructor(opts = {}) {
+        this.sessionName = opts.session ?? "lex-bot";
+    }
+    async run(args) {
+        const { stdout } = await execFileAsync(process.execPath, [CLI_JS, `-s=${this.sessionName}`, ...args], {
+            maxBuffer: 16 * 1024 * 1024,
+        });
+        return stdout;
+    }
+    async ensureUrl(url) {
+        if (url) {
+            if (this.opened)
+                await this.run(["goto", url]);
+            else {
+                await this.run(["open", url]);
+                this.opened = true;
+            }
+        }
+        else if (!this.opened) {
+            await this.run(["open"]);
+            this.opened = true;
+        }
+    }
+    async observe(opts) {
+        await this.ensureUrl(opts.url);
+        const ariaSnapshot = (await this.run(["--raw", "snapshot"])).trim();
+        const dir = await mkdtemp(join(tmpdir(), "qa-cli-shot-"));
+        const shot = join(dir, "shot.png");
+        let screenshotB64 = "";
+        try {
+            await this.run(["screenshot", `--filename=${shot}`]);
+            screenshotB64 = (await readFile(shot)).toString("base64");
+            await unlink(shot).catch(() => undefined);
+        }
+        catch {
+            // the screenshot is not critical for observe
+        }
+        const url = opts.url ?? (await this.run(["--raw", "eval", "location.href"])).trim();
+        return { url, screenshotB64, ariaSnapshot, capturedBy: "cli" };
+    }
+    async act(action) {
+        try {
+            if (action.kind === "navigate") {
+                await this.ensureUrl(action.url);
+                return { ok: true };
+            }
+            if (action.kind === "click")
+                await this.run(["click", action.ref]);
+            else
+                await this.run(["fill", action.ref, action.value]);
+            return { ok: true, ref: action.ref };
+        }
+        catch (e) {
+            const ref = "ref" in action ? action.ref : undefined;
+            return { ok: false, ref, error: e.message };
+        }
+    }
+    async close() {
+        if (this.opened) {
+            await this.run(["close"]).catch(() => undefined);
+            this.opened = false;
+        }
+    }
+}
+//# sourceMappingURL=playwright-cli.js.map

package/dist/browser/backends/playwright-cli.js.map

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

package/dist/browser/backends/playwright-lib.d.ts

@@ -0,0 +1,32 @@
+import type { BrowserBackend } from "../gateway.js";
+import type { ActResult, Action, ElementRef, ElementState, Observation, ObserveOptions, SessionApi, StorageState, TestRunReport, VerifiedElement } from "../types.js";
+export interface PlaywrightLibOptions {
+    headless?: boolean;
+    storageState?: StorageState;
+    /** Browser channel (chrome/msedge) — for bypassing automation detection (e.g. Google OAuth). */
+    channel?: string;
+}
+/**
+ * PRIMARY backend (ADR-0003): in-process Playwright. Owns storageState; captures ariaSnapshot+screenshot;
+ * runs tests (Sprint 3). act() resolves ref→getByRole(role,{name}) based on the last observe().
+ */
+export declare class PlaywrightLibBackend implements BrowserBackend {
+    private readonly opts;
+    private browser?;
+    private context?;
+    private page?;
+    private readonly refMap;
+    private currentUrl;
+    private readonly consoleErrors;
+    constructor(opts?: PlaywrightLibOptions);
+    private launch;
+    private ensurePage;
+    observe(opts: ObserveOptions): Promise<Observation>;
+    act(action: Action): Promise<ActResult>;
+    verify(elements: ElementRef[]): Promise<VerifiedElement[]>;
+    getState(el: ElementRef): Promise<ElementState>;
+    session(): SessionApi;
+    runTests(): Promise<TestRunReport>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=playwright-lib.d.ts.map

package/dist/browser/backends/playwright-lib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright-lib.d.ts","sourceRoot":"","sources":["../../../src/browser/backends/playwright-lib.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EACV,SAAS,EACT,MAAM,EACN,UAAU,EACV,YAAY,EACZ,WAAW,EACX,cAAc,EACd,UAAU,EACV,YAAY,EACZ,aAAa,EACb,eAAe,EAChB,MAAM,aAAa,CAAC;AAOrB,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,gGAAgG;IAChG,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,cAAc;IAQ7C,OAAO,CAAC,QAAQ,CAAC,IAAI;IAPjC,OAAO,CAAC,OAAO,CAAC,CAAU;IAC1B,OAAO,CAAC,OAAO,CAAC,CAAiB;IACjC,OAAO,CAAC,IAAI,CAAC,CAAO;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsD;IAC7E,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;gBAEjB,IAAI,GAAE,oBAAyB;IAE5D,OAAO,CAAC,MAAM;YAQA,UAAU;IAmBlB,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC;IA2BnD,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAwBvC,MAAM,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAiB1D,QAAQ,CAAC,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC;IAgBrD,OAAO,IAAI,UAAU;IAqBf,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC;IAIlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ7B"}

package/dist/browser/backends/playwright-lib.js

@@ -0,0 +1,157 @@
+import { chromium } from "playwright";
+import { parseAriaSnapshot } from "../../observe/parse-aria.js";
+/**
+ * PRIMARY backend (ADR-0003): in-process Playwright. Owns storageState; captures ariaSnapshot+screenshot;
+ * runs tests (Sprint 3). act() resolves ref→getByRole(role,{name}) based on the last observe().
+ */
+export class PlaywrightLibBackend {
+    opts;
+    browser;
+    context;
+    page;
+    refMap = new Map();
+    currentUrl = "";
+    consoleErrors = [];
+    constructor(opts = {}) {
+        this.opts = opts;
+    }
+    launch() {
+        return chromium.launch({
+            headless: this.opts.headless ?? true,
+            channel: this.opts.channel,
+            args: ["--disable-blink-features=AutomationControlled"],
+        });
+    }
+    async ensurePage() {
+        this.browser ??= await this.launch();
+        if (!this.context) {
+            this.context = await this.browser.newContext(this.opts.storageState
+                ? { storageState: this.opts.storageState }
+                : {});
+        }
+        if (!this.page) {
+            this.page = await this.context.newPage();
+            this.page.on("console", (m) => {
+                if (m.type() === "error")
+                    this.consoleErrors.push(m.text());
+            });
+            this.page.on("pageerror", (e) => this.consoleErrors.push(e.message));
+        }
+        return this.page;
+    }
+    async observe(opts) {
+        const page = await this.ensurePage();
+        if (opts.url) {
+            await page.goto(opts.url, { waitUntil: "domcontentloaded" });
+            this.currentUrl = opts.url;
+        }
+        // SPA hydration: content loads asynchronously AFTER domcontentloaded.
+        // Without this, the snapshot = only the static shell (nav), without the real page content.
+        await page.waitForLoadState("networkidle", { timeout: 10_000 }).catch(() => undefined);
+        await page.waitForTimeout(500);
+        const ariaSnapshot = await page.locator("body").ariaSnapshot();
+        const buf = await page.screenshot({ fullPage: opts.fullPage ?? false });
+        this.refMap.clear();
+        for (const el of parseAriaSnapshot(ariaSnapshot)) {
+            this.refMap.set(el.ref, { role: el.role, name: el.name });
+        }
+        return {
+            url: this.currentUrl || page.url(),
+            screenshotB64: buf.toString("base64"),
+            ariaSnapshot,
+            capturedBy: "lib",
+            consoleErrors: [...this.consoleErrors],
+        };
+    }
+    async act(action) {
+        try {
+            const page = await this.ensurePage();
+            if (action.kind === "navigate") {
+                await page.goto(action.url, { waitUntil: "domcontentloaded" });
+                this.currentUrl = action.url;
+                return { ok: true };
+            }
+            const target = this.refMap.get(action.ref);
+            if (!target) {
+                return { ok: false, ref: action.ref, error: `Unknown ref '${action.ref}' — call observe() first.` };
+            }
+            const locator = page
+                .getByRole(target.role, target.name ? { name: target.name, exact: true } : {})
+                .first();
+            if (action.kind === "click")
+                await locator.click();
+            else
+                await locator.fill(action.value);
+            return { ok: true, ref: action.ref };
+        }
+        catch (e) {
+            const ref = "ref" in action ? action.ref : undefined;
+            return { ok: false, ref, error: e.message };
+        }
+    }
+    async verify(elements) {
+        const page = await this.ensurePage();
+        const out = [];
+        for (const el of elements) {
+            let count = -1;
+            try {
+                count = await page
+                    .getByRole(el.role, el.name ? { name: el.name, exact: true } : {})
+                    .count();
+            }
+            catch {
+                count = -1;
+            }
+            out.push({ ...el, count, verified: count === 1 });
+        }
+        return out;
+    }
+    async getState(el) {
+        const page = await this.ensurePage();
+        const loc = page
+            .getByRole(el.role, el.name ? { name: el.name, exact: true } : {})
+            .first();
+        const visible = await loc.isVisible().catch(() => false);
+        const enabled = visible ? await loc.isEnabled().catch(() => false) : false;
+        let checked;
+        try {
+            checked = await loc.isChecked();
+        }
+        catch {
+            checked = undefined; // not checkable
+        }
+        return { visible, enabled, checked };
+    }
+    session() {
+        return {
+            load: async (state) => {
+                await this.page?.close().catch(() => undefined);
+                await this.context?.close().catch(() => undefined);
+                this.page = undefined;
+                this.browser ??= await this.launch();
+                this.context = await this.browser.newContext({
+                    storageState: state,
+                });
+                this.page = await this.context.newPage();
+            },
+            save: async () => {
+                if (!this.context) {
+                    throw new Error("No active context — call observe()/navigate() first.");
+                }
+                return (await this.context.storageState());
+            },
+        };
+    }
+    async runTests() {
+        throw new Error("runTests is implemented in Sprint 3.");
+    }
+    async close() {
+        await this.page?.close().catch(() => undefined);
+        await this.context?.close().catch(() => undefined);
+        await this.browser?.close().catch(() => undefined);
+        this.page = undefined;
+        this.context = undefined;
+        this.browser = undefined;
+    }
+}
+//# sourceMappingURL=playwright-lib.js.map

package/dist/browser/backends/playwright-lib.js.map

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

package/dist/browser/gateway.d.ts

@@ -0,0 +1,33 @@
+import type { ActResult, Action, ElementRef, ElementState, Observation, ObserveOptions, SessionApi, TestRunReport, VerifiedElement } from "./types.js";
+/**
+ * A single browser backend. Both (playwright-lib, playwright-cli) implement observe/act/close;
+ * `runTests`/`session` — lib only (the CLI does not run tests and does not own storageState, ADR-0003).
+ */
+export interface BrowserBackend {
+    observe(opts: ObserveOptions): Promise<Observation>;
+    act(action: Action): Promise<ActResult>;
+    /** Verify locators on the current page (count per element). */
+    verify?(elements: ElementRef[]): Promise<VerifiedElement[]>;
+    /** Current element state (visible/enabled/checked) — for act→observe. */
+    getState?(element: ElementRef): Promise<ElementState>;
+    session?(): SessionApi;
+    runTests?(globs: string[]): Promise<TestRunReport>;
+    close(): Promise<void>;
+}
+/**
+ * Hybrid abstraction (ADR-0003). The agent always talks to it.
+ * Routing: observe/act → backend per config; runTests/session → ALWAYS lib.
+ */
+export interface BrowserGateway {
+    observe(opts: ObserveOptions): Promise<Observation>;
+    act(action: Action): Promise<ActResult>;
+    /** Verify-before-design: check locators (count===1) on the observed page. */
+    verify(elements: ElementRef[]): Promise<VerifiedElement[]>;
+    /** Element state (visible/enabled/checked) — for act→observe grounding. */
+    getState(element: ElementRef): Promise<ElementState>;
+    session(): SessionApi;
+    runTests(globs: string[]): Promise<TestRunReport>;
+    close(): Promise<void>;
+}
+export type { BrowserBackend as Backend };
+//# sourceMappingURL=gateway.d.ts.map

package/dist/browser/gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../../src/browser/gateway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,MAAM,EACN,UAAU,EACV,YAAY,EACZ,WAAW,EACX,cAAc,EACd,UAAU,EACV,aAAa,EACb,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACpD,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IACxC,+DAA+D;IAC/D,MAAM,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAC5D,yEAAyE;IACzE,QAAQ,CAAC,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACtD,OAAO,CAAC,IAAI,UAAU,CAAC;IACvB,QAAQ,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACnD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACpD,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IACxC,6EAA6E;IAC7E,MAAM,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAC3D,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACrD,OAAO,IAAI,UAAU,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAClD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,YAAY,EAAE,cAAc,IAAI,OAAO,EAAE,CAAC"}

package/dist/browser/gateway.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=gateway.js.map

package/dist/browser/gateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.js","sourceRoot":"","sources":["../../src/browser/gateway.ts"],"names":[],"mappings":""}

package/dist/browser/index.d.ts

@@ -0,0 +1,15 @@
+import type { BrowserGateway } from "./gateway.js";
+import type { BackendKind, StorageState } from "./types.js";
+export * from "./gateway.js";
+export * from "./types.js";
+/** Factory config — browser only (independent of the LLM config). */
+export interface GatewayConfig {
+    backend: BackendKind;
+    headless?: boolean;
+    /** Saved session (cookies+localStorage) for authenticated observe. */
+    storageState?: StorageState;
+    /** Browser channel (chrome/msedge) — bypasses automation detection. */
+    channel?: string;
+}
+export declare function makeGateway(cfg: GatewayConfig): BrowserGateway;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAkB,cAAc,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,KAAK,EAGV,WAAW,EAMX,YAAY,EAGb,MAAM,YAAY,CAAC;AAEpB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAE3B,qEAAqE;AACrE,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sEAAsE;IACtE,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAuCD,wBAAgB,WAAW,CAAC,GAAG,EAAE,aAAa,GAAG,cAAc,CAW9D"}