@plune-ai/cairn 0.2.1

package/dist/llm/vision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vision.d.ts","sourceRoot":"","sources":["../../src/llm/vision.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAE3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,SAAc,GAAG,UAAU,CAE/E"}

package/dist/llm/vision.js

@@ -0,0 +1,4 @@
+export function imageBlock(dataB64, mediaType = "image/png") {
+    return { type: "image_url", image_url: { url: `data:${mediaType};base64,${dataB64}` } };
+}
+//# sourceMappingURL=vision.js.map

package/dist/llm/vision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vision.js","sourceRoot":"","sources":["../../src/llm/vision.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,SAAS,GAAG,WAAW;IACjE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,QAAQ,SAAS,WAAW,OAAO,EAAE,EAAE,EAAE,CAAC;AAC1F,CAAC"}

package/dist/observe/index.d.ts

@@ -0,0 +1,21 @@
+import type { BrowserGateway } from "../browser/gateway.js";
+import type { BackendKind, ElementRef } from "../browser/types.js";
+export { parseAriaSnapshot } from "./parse-aria.js";
+/** Model-ready normalized page observation. */
+export interface PageStudy {
+    url: string;
+    screenshotB64: string;
+    ariaYaml: string;
+    elements: ElementRef[];
+    capturedBy: BackendKind;
+    /** Page JS errors (console.error + uncaught), if the backend captures them. */
+    consoleErrors?: string[];
+}
+/**
+ * Explore the page through the gateway and normalize it into a `PageStudy`
+ * (the same shape regardless of the backend — ADR-0003).
+ */
+export declare function capture(gateway: BrowserGateway, url: string, opts?: {
+    fullPage?: boolean;
+}): Promise<PageStudy>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observe/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,+CAA+C;AAC/C,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,UAAU,EAAE,WAAW,CAAC;IACxB,+EAA+E;IAC/E,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAC3B,OAAO,EAAE,cAAc,EACvB,GAAG,EAAE,MAAM,EACX,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GAChC,OAAO,CAAC,SAAS,CAAC,CAUpB"}

package/dist/observe/index.js

@@ -0,0 +1,18 @@
+import { parseAriaSnapshot } from "./parse-aria.js";
+export { parseAriaSnapshot } from "./parse-aria.js";
+/**
+ * Explore the page through the gateway and normalize it into a `PageStudy`
+ * (the same shape regardless of the backend — ADR-0003).
+ */
+export async function capture(gateway, url, opts = {}) {
+    const obs = await gateway.observe({ url, fullPage: opts.fullPage });
+    return {
+        url: obs.url,
+        screenshotB64: obs.screenshotB64,
+        ariaYaml: obs.ariaSnapshot,
+        elements: parseAriaSnapshot(obs.ariaSnapshot),
+        capturedBy: obs.capturedBy,
+        consoleErrors: obs.consoleErrors,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/observe/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/observe/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAapD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,OAAuB,EACvB,GAAW,EACX,OAA+B,EAAE;IAEjC,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IACpE,OAAO;QACL,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,aAAa,EAAE,GAAG,CAAC,aAAa;QAChC,QAAQ,EAAE,GAAG,CAAC,YAAY;QAC1B,QAAQ,EAAE,iBAAiB,CAAC,GAAG,CAAC,YAAY,CAAC;QAC7C,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,aAAa,EAAE,GAAG,CAAC,aAAa;KACjC,CAAC;AACJ,CAAC"}

package/dist/observe/parse-aria.d.ts

@@ -0,0 +1,8 @@
+import type { ElementRef } from "../browser/types.js";
+/**
+ * Parses the Playwright `ariaSnapshot()` output (YAML-like) into ranked `ElementRef[]`
+ * in document order. Skips property lines (`/url`, `/checked`…) and text nodes (`text:`).
+ * A pure function — fully testable without a browser.
+ */
+export declare function parseAriaSnapshot(aria: string): ElementRef[];
+//# sourceMappingURL=parse-aria.d.ts.map

package/dist/observe/parse-aria.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-aria.d.ts","sourceRoot":"","sources":["../../src/observe/parse-aria.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AA6CtD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,CAuB5D"}

package/dist/observe/parse-aria.js

@@ -0,0 +1,71 @@
+/** Roles the user interacts with (priority for test cases). */
+const INTERACTIVE = new Set([
+    "button",
+    "link",
+    "textbox",
+    "checkbox",
+    "radio",
+    "combobox",
+    "listbox",
+    "option",
+    "switch",
+    "slider",
+    "searchbox",
+    "spinbutton",
+    "menuitem",
+    "menuitemcheckbox",
+    "menuitemradio",
+    "tab",
+    "gridcell",
+    "treeitem",
+]);
+/** Semantic containers — low but non-zero priority. */
+const LANDMARK = new Set([
+    "main",
+    "navigation",
+    "banner",
+    "complementary",
+    "contentinfo",
+    "region",
+    "form",
+    "search",
+    "article",
+    "dialog",
+]);
+function rankFor(role, interactive) {
+    if (interactive)
+        return 3;
+    if (role === "heading")
+        return 2;
+    if (LANDMARK.has(role))
+        return 1;
+    return 0;
+}
+/**
+ * Parses the Playwright `ariaSnapshot()` output (YAML-like) into ranked `ElementRef[]`
+ * in document order. Skips property lines (`/url`, `/checked`…) and text nodes (`text:`).
+ * A pure function — fully testable without a browser.
+ */
+export function parseAriaSnapshot(aria) {
+    const out = [];
+    let n = 0;
+    for (const raw of aria.split(/\r?\n/)) {
+        const line = raw.trimStart();
+        if (!line.startsWith("- "))
+            continue;
+        const content = line.slice(2).trim();
+        if (content.startsWith("/"))
+            continue; // property: /url, /checked, /disabled…
+        const role = content.match(/^([a-zA-Z][\w-]*)/)?.[1];
+        if (!role || role === "text")
+            continue; // text node or unparseable
+        const name = content.match(/"([^"]*)"/)?.[1];
+        // A native ref from the cli/MCP snapshot (`[ref=e15]`) takes priority over a synthesized one.
+        const nativeRef = content.match(/\[ref=([^\]\s]+)\]/)?.[1];
+        const interactive = INTERACTIVE.has(role);
+        n += 1;
+        out.push({ ref: nativeRef ?? `e${n}`, role, name, interactive, rank: rankFor(role, interactive) });
+    }
+    return out;
+}
+//# sourceMappingURL=parse-aria.js.map

package/dist/observe/parse-aria.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-aria.js","sourceRoot":"","sources":["../../src/observe/parse-aria.ts"],"names":[],"mappings":"AAEA,+DAA+D;AAC/D,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;IAC1B,QAAQ;IACR,MAAM;IACN,SAAS;IACT,UAAU;IACV,OAAO;IACP,UAAU;IACV,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,WAAW;IACX,YAAY;IACZ,UAAU;IACV,kBAAkB;IAClB,eAAe;IACf,KAAK;IACL,UAAU;IACV,UAAU;CACX,CAAC,CAAC;AAEH,uDAAuD;AACvD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC;IACvB,MAAM;IACN,YAAY;IACZ,QAAQ;IACR,eAAe;IACf,aAAa;IACb,QAAQ;IACR,MAAM;IACN,QAAQ;IACR,SAAS;IACT,QAAQ;CACT,CAAC,CAAC;AAEH,SAAS,OAAO,CAAC,IAAY,EAAE,WAAoB;IACjD,IAAI,WAAW;QAAE,OAAO,CAAC,CAAC;IAC1B,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IACjC,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IACjC,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,GAAG,GAAiB,EAAE,CAAC;IAC7B,IAAI,CAAC,GAAG,CAAC,CAAC;IAEV,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,GAAG,CAAC,SAAS,EAAE,CAAC;QAC7B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAS;QAErC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACrC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS,CAAC,uCAAuC;QAE9E,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACrD,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,MAAM;YAAE,SAAS,CAAC,2BAA2B;QAEnE,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7C,8FAA8F;QAC9F,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3D,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1C,CAAC,IAAI,CAAC,CAAC;QACP,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,SAAS,IAAI,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC;IACrG,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/probe/index.d.ts

@@ -0,0 +1,19 @@
+import type { BrowserGateway } from "../browser/index.js";
+import type { ElementRef, ElementState } from "../browser/types.js";
+/** An observed state transition after a safe action (act→observe). */
+export interface Transition {
+    ref: string;
+    role: string;
+    name?: string;
+    before: ElementState;
+    after: ElementState;
+}
+/** Convert transitions into text for the prompt (designer/codegen ground assertions on them). */
+export declare function formatTransitions(transitions: Transition[]): string;
+/**
+ * Stage B grounding: for safe (reversible) elements, perform a click, OBSERVE the state transition,
+ * and revert it. Does NOT touch buttons (submit/delete), links (navigation), or file inputs.
+ * Gives the designer real transitions instead of guessed ones → grounds state-transition assertions.
+ */
+export declare function probeTransitions(gateway: BrowserGateway, elements: ElementRef[]): Promise<Transition[]>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/probe/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEpE,sEAAsE;AACtE,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,YAAY,CAAC;CACrB;AAKD,iGAAiG;AACjG,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,MAAM,CAWnE;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,UAAU,EAAE,GACrB,OAAO,CAAC,UAAU,EAAE,CAAC,CAevB"}

package/dist/probe/index.js

@@ -0,0 +1,38 @@
+/** Reversible roles that are safe to click (restored by a reverse click). */
+const SAFE_ROLES = new Set(["switch", "checkbox", "radio"]);
+/** Convert transitions into text for the prompt (designer/codegen ground assertions on them). */
+export function formatTransitions(transitions) {
+    if (transitions.length === 0)
+        return "(no observed transitions — assertions on the static state only)";
+    return transitions
+        .map((t) => {
+        const change = t.before.checked !== undefined && t.after.checked !== undefined
+            ? `checked ${t.before.checked}→${t.after.checked}`
+            : `enabled ${t.before.enabled}→${t.after.enabled}`;
+        return `- click ${t.ref} (${t.role}${t.name ? ` "${t.name}"` : ""}): ${change}`;
+    })
+        .join("\n");
+}
+/**
+ * Stage B grounding: for safe (reversible) elements, perform a click, OBSERVE the state transition,
+ * and revert it. Does NOT touch buttons (submit/delete), links (navigation), or file inputs.
+ * Gives the designer real transitions instead of guessed ones → grounds state-transition assertions.
+ */
+export async function probeTransitions(gateway, elements) {
+    const out = [];
+    for (const el of elements) {
+        if (!SAFE_ROLES.has(el.role))
+            continue;
+        const before = await gateway.getState(el);
+        if (!before.visible || !before.enabled)
+            continue; // don't touch hidden/disabled
+        const clicked = await gateway.act({ kind: "click", ref: el.ref });
+        if (!clicked.ok)
+            continue;
+        const after = await gateway.getState(el);
+        await gateway.act({ kind: "click", ref: el.ref }).catch(() => undefined); // revert (reversibility)
+        out.push({ ref: el.ref, role: el.role, name: el.name, before, after });
+    }
+    return out;
+}
+//# sourceMappingURL=index.js.map

package/dist/probe/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/probe/index.ts"],"names":[],"mappings":"AAYA,6EAA6E;AAC7E,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;AAE5D,iGAAiG;AACjG,MAAM,UAAU,iBAAiB,CAAC,WAAyB;IACzD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,iEAAiE,CAAC;IACvG,OAAO,WAAW;SACf,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,MAAM,GACV,CAAC,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS;YAC7D,CAAC,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE;YAClD,CAAC,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACvD,OAAO,WAAW,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,MAAM,EAAE,CAAC;IAClF,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAuB,EACvB,QAAsB;IAEtB,MAAM,GAAG,GAAiB,EAAE,CAAC;IAC7B,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;QAC1B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC;YAAE,SAAS;QACvC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,SAAS,CAAC,8BAA8B;QAEhF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;QAClE,IAAI,CAAC,OAAO,CAAC,EAAE;YAAE,SAAS;QAC1B,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACzC,MAAM,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,yBAAyB;QAEnG,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/promote/index.d.ts

@@ -0,0 +1,6 @@
+export { promoteCase } from "./promote-case.js";
+export type { PromoteResult } from "./promote-case.js";
+export { collectSelectors } from "./selectors.js";
+export type { PromoteDeps, CollectedSelectors } from "./selectors.js";
+export { locatorFor } from "../artifacts/report.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/promote/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/promote/index.js

@@ -0,0 +1,4 @@
+export { promoteCase } from "./promote-case.js";
+export { collectSelectors } from "./selectors.js";
+export { locatorFor } from "../artifacts/report.js";
+//# sourceMappingURL=index.js.map

package/dist/promote/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/promote/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/promote/promote-case.d.ts

@@ -0,0 +1,12 @@
+import { type PromoteDeps } from "./selectors.js";
+export interface PromoteResult {
+    oldId: string;
+    newId: string;
+    oldFile: string;
+    newFile: string;
+    selectorsFilled: number;
+    missingRefs: string[];
+    warning?: string;
+}
+export declare function promoteCase(runDir: string, caseId: string, deps?: PromoteDeps): Promise<PromoteResult>;
+//# sourceMappingURL=promote-case.d.ts.map

package/dist/promote/promote-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promote-case.d.ts","sourceRoot":"","sources":["../../src/promote/promote-case.ts"],"names":[],"mappings":"AAGA,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEpE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAmED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,aAAa,CAAC,CAyCxB"}

package/dist/promote/promote-case.js

@@ -0,0 +1,103 @@
+import { readFile, writeFile, readdir, unlink } from "node:fs/promises";
+import { join } from "node:path";
+import { parseTestCaseMd } from "../artifacts/testcase-md.js";
+import { collectSelectors } from "./selectors.js";
+/** MTC-<SUITE>-NNN → <SUITE> (suite may contain dashes; strip leading kind + trailing number). */
+function suiteOf(id) {
+    const m = id.match(/^(?:MTC|ATC)-(.+)-(\d+)$/);
+    return m?.[1] ?? "";
+}
+function escapeRe(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/** Next free ATC number for a suite, scanning testcases/ filenames. */
+async function nextAtcNumber(tcDir, suite) {
+    const files = await readdir(tcDir);
+    const re = new RegExp(`^ATC-${escapeRe(suite)}-(\\d+)\\.md$`);
+    let max = 0;
+    for (const f of files) {
+        const m = f.match(re);
+        if (m?.[1] != null)
+            max = Math.max(max, Number(m[1]));
+    }
+    return max + 1;
+}
+/** Replace (or insert) a key in the leading `---` frontmatter block. */
+function setFrontmatter(md, key, value) {
+    const fmEnd = md.indexOf("\n---\n");
+    if (fmEnd === -1)
+        return md; // no frontmatter — bail
+    const fm = md.slice(0, fmEnd);
+    const rest = md.slice(fmEnd);
+    const re = new RegExp(`^(${escapeRe(key)}:).*$`, "m");
+    if (re.test(fm))
+        return fm.replace(re, `$1 ${value}`) + rest;
+    return `${fm}\n${key}: ${value}${rest}`;
+}
+/** Recover elementRefs by matching the case title against report.json. */
+async function elementRefsForTitle(runDir, title) {
+    try {
+        const rep = JSON.parse(await readFile(join(runDir, "report.json"), "utf8"));
+        const hit = (rep.testCases ?? []).find((t) => t.title === title);
+        return hit?.elementRefs ?? [];
+    }
+    catch {
+        return [];
+    }
+}
+/** Insert a `## Selectors` table after the body (if absent). */
+function injectSelectors(md, selectors) {
+    if (selectors.length === 0 || md.includes("## Selectors"))
+        return md;
+    const rows = selectors.map((s) => `| ${s.label} | \`${s.locator}\` |`).join("\n");
+    const block = `\n## Selectors (recorded during promote)\n\n| Element | Locator |\n| --- | --- |\n${rows}\n`;
+    return md.trimEnd() + "\n" + block;
+}
+/** Append a "Promoted from" row to the ## Traceability section (create it if absent). */
+function appendTraceability(md, oldId) {
+    const row = `| Promoted from | ${oldId} |`;
+    const m = md.match(/## Traceability\b[\s\S]*?(?=\n## |\n*$)/);
+    if (m) {
+        const section = m[0].trimEnd();
+        return md.replace(m[0], () => `${section}\n${row}`);
+    }
+    return `${md.trimEnd()}\n\n## Traceability\n\n| Source | Reference |\n| --- | --- |\n${row}\n`;
+}
+export async function promoteCase(runDir, caseId, deps = {}) {
+    if (!caseId.startsWith("MTC")) {
+        throw new Error(`Cannot promote ${caseId}: only MTC-* (manual) cases can be promoted.`);
+    }
+    const tcDir = join(runDir, "testcases");
+    const oldFile = join(tcDir, `${caseId}.md`);
+    const md = await readFile(oldFile, "utf8");
+    const parsed = parseTestCaseMd(md);
+    const suite = suiteOf(caseId);
+    const num = await nextAtcNumber(tcDir, suite);
+    const newId = `ATC-${suite}-${String(num).padStart(3, "0")}`;
+    const newFile = join(tcDir, `${newId}.md`);
+    let selectorsFilled = 0;
+    let missingRefs = [];
+    let updated = md;
+    if (parsed.selectors.length === 0) {
+        const refs = await elementRefsForTitle(runDir, parsed.title);
+        const { selectors, missing } = await collectSelectors(runDir, refs, deps);
+        selectorsFilled = selectors.length;
+        missingRefs = missing;
+        updated = injectSelectors(updated, selectors);
+    }
+    const automation = `tests/ui/${suite.toLowerCase()}/${newId.toLowerCase()}.spec.ts`;
+    updated = setFrontmatter(updated, "id", newId);
+    updated = setFrontmatter(updated, "execution", "auto");
+    updated = setFrontmatter(updated, "status", "❌ Not implemented");
+    updated = setFrontmatter(updated, "automation", automation);
+    updated = updated.replace(/^(#\s+)(?:MTC|ATC)-[A-Za-z0-9-]+-\d+(:)/m, `$1${newId}$2`);
+    updated = appendTraceability(updated, caseId);
+    await writeFile(newFile, updated, "utf8");
+    if (newFile !== oldFile)
+        await unlink(oldFile); // in-place rename
+    const warning = missingRefs.length > 0
+        ? `${missingRefs.length} ref(s) without a selector — generated code will be incomplete.`
+        : undefined;
+    return { oldId: caseId, newId, oldFile, newFile, selectorsFilled, missingRefs, warning };
+}
+//# sourceMappingURL=promote-case.js.map

package/dist/promote/promote-case.js.map

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

package/dist/promote/selectors.d.ts

@@ -0,0 +1,29 @@
+export interface PromoteDeps {
+    /**
+     * Live browser fallback for refs missing from study.json. Omit → offline-only.
+     *
+     * Returns a `Map<ref, locator>` only — element names are not available in the
+     * live path, so any selector produced here will be labeled by its ref string
+     * (e.g. `"e99"`) rather than a human-readable name.
+     */
+    collectLive?: (url: string, refs: string[]) => Promise<Map<string, string>>;
+}
+export interface CollectedSelectors {
+    selectors: {
+        label: string;
+        locator: string;
+    }[];
+    missing: string[];
+}
+/**
+ * Build selectors for the given elementRefs.
+ *
+ * Resolution order: study.json (offline) → optional live browser fallback.
+ *
+ * **Label convention:**
+ * - Elements found in study.json → `label` is `name ?? role` (human-readable).
+ * - Elements found only via `collectLive` → `label` is the ref string (e.g. `"e99"`),
+ *   because the live path returns locators only and does not expose element names.
+ */
+export declare function collectSelectors(runDir: string, elementRefs: string[], deps?: PromoteDeps): Promise<CollectedSelectors>;
+//# sourceMappingURL=selectors.d.ts.map

package/dist/promote/selectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.d.ts","sourceRoot":"","sources":["../../src/promote/selectors.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,WAAW;IAC1B;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC7E;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAChD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EAAE,EACrB,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,kBAAkB,CAAC,CA0C7B"}

package/dist/promote/selectors.js

@@ -0,0 +1,58 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { locatorFor } from "../artifacts/report.js";
+/**
+ * Build selectors for the given elementRefs.
+ *
+ * Resolution order: study.json (offline) → optional live browser fallback.
+ *
+ * **Label convention:**
+ * - Elements found in study.json → `label` is `name ?? role` (human-readable).
+ * - Elements found only via `collectLive` → `label` is the ref string (e.g. `"e99"`),
+ *   because the live path returns locators only and does not expose element names.
+ */
+export async function collectSelectors(runDir, elementRefs, deps = {}) {
+    let elements = [];
+    try {
+        const study = JSON.parse(await readFile(join(runDir, "study.json"), "utf8"));
+        elements = study.elements ?? [];
+    }
+    catch {
+        // no study.json — every ref is missing (live fallback may still fill them)
+    }
+    const byRef = new Map(elements.map((e) => [e.ref, e]));
+    const selectors = [];
+    const missing = [];
+    for (const ref of elementRefs) {
+        const el = byRef.get(ref);
+        if (el)
+            selectors.push({ label: el.name ?? el.role, locator: locatorFor(el) });
+        else
+            missing.push(ref);
+    }
+    if (missing.length === 0 || !deps.collectLive)
+        return { selectors, missing };
+    let url = "";
+    try {
+        const rep = JSON.parse(await readFile(join(runDir, "report.json"), "utf8"));
+        url = rep.url ?? "";
+    }
+    catch {
+        // no report.json → cannot navigate
+    }
+    if (!url) {
+        // collectLive provided but no url available → cannot navigate; leave refs in missing
+        return { selectors, missing };
+    }
+    const live = await deps.collectLive(url, missing);
+    const stillMissing = [];
+    for (const ref of missing) {
+        const loc = live.get(ref);
+        if (loc)
+            selectors.push({ label: ref, locator: loc });
+        else
+            stillMissing.push(ref);
+    }
+    return { selectors, missing: stillMissing };
+}
+//# sourceMappingURL=selectors.js.map

package/dist/promote/selectors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.js","sourceRoot":"","sources":["../../src/promote/selectors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAmBpD;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAc,EACd,WAAqB,EACrB,OAAoB,EAAE;IAEtB,IAAI,QAAQ,GAAiB,EAAE,CAAC;IAChC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,CAE1E,CAAC;QACF,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,2EAA2E;IAC7E,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAEvD,MAAM,SAAS,GAAyC,EAAE,CAAC;IAC3D,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,EAAE;YAAE,SAAS,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;;YAC1E,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW;QAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;IAE7E,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,CAAC,CAAqB,CAAC;QAChG,GAAG,GAAG,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,mCAAmC;IACrC,CAAC;IACD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,qFAAqF;QACrF,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;IAChC,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAClD,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,GAAG;YAAE,SAAS,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;;YACjD,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC;AAC9C,CAAC"}

package/dist/prompts/index.d.ts

@@ -0,0 +1,32 @@
+export { LOCAL_PROMPTS } from "./local/index.js";
+export interface CompiledPrompt {
+    name: string;
+    text: string;
+    version: number | "local";
+    isFallback: boolean;
+}
+/** Source of versioned prompts (e.g. Langfuse). Returns null if the prompt is absent. */
+export interface PromptFetcher {
+    fetch(name: string): Promise<{
+        text: string;
+        version: number;
+    } | null>;
+}
+export interface PromptRegistryOptions {
+    fetcher?: PromptFetcher;
+    local?: Record<string, string>;
+    /** Directory of .md overrides (default ./prompts): edit a prompt without rebuilding. `<name>.md` > local constant. */
+    overridesDir?: string;
+}
+/**
+ * Prompt registry (ADR-0004): Langfuse first (if a fetcher is injected), otherwise the local fallback.
+ * `{{var}}` is interpolated; a missing variable → empty. The bot works offline on local prompts.
+ */
+export declare class PromptRegistry {
+    private readonly opts;
+    private readonly local;
+    private readonly overridesDir;
+    constructor(opts?: PromptRegistryOptions);
+    getPrompt(name: string, vars?: Record<string, string>): Promise<CompiledPrompt>;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,yFAAyF;AACzF,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;CACxE;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,sHAAsH;IACtH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAMD;;;GAGG;AACH,qBAAa,cAAc;IAGb,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAC/C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBACT,IAAI,GAAE,qBAA0B;IAKvD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,OAAO,CAAC,cAAc,CAAC;CAmC1F"}

package/dist/prompts/index.js

@@ -0,0 +1,55 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { LOCAL_PROMPTS } from "./local/index.js";
+export { LOCAL_PROMPTS } from "./local/index.js";
+function interpolate(tpl, vars) {
+    return tpl.replace(/\{\{\s*(\w+)\s*\}\}/g, (_, key) => vars[key] ?? "");
+}
+/**
+ * Prompt registry (ADR-0004): Langfuse first (if a fetcher is injected), otherwise the local fallback.
+ * `{{var}}` is interpolated; a missing variable → empty. The bot works offline on local prompts.
+ */
+export class PromptRegistry {
+    opts;
+    local;
+    overridesDir;
+    constructor(opts = {}) {
+        this.opts = opts;
+        this.local = opts.local ?? LOCAL_PROMPTS;
+        this.overridesDir = opts.overridesDir ?? "prompts";
+    }
+    async getPrompt(name, vars = {}) {
+        let raw;
+        let version = "local";
+        let isFallback = true;
+        if (this.opts.fetcher) {
+            try {
+                const remote = await this.opts.fetcher.fetch(name);
+                if (remote) {
+                    raw = remote.text;
+                    version = remote.version;
+                    isFallback = false;
+                }
+            }
+            catch {
+                // Langfuse unavailable → local fallback.
+            }
+        }
+        if (raw === undefined) {
+            try {
+                raw = await readFile(join(this.overridesDir, `${name}.md`), "utf8");
+            }
+            catch {
+                // no .md override → local constant
+            }
+        }
+        if (raw === undefined) {
+            raw = this.local[name];
+            if (raw === undefined) {
+                throw new Error(`Prompt '${name}' not found (neither in Langfuse nor locally).`);
+            }
+        }
+        return { name, text: interpolate(raw, vars), version, isFallback };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAqBjD,SAAS,WAAW,CAAC,GAAW,EAAE,IAA4B;IAC5D,OAAO,GAAG,CAAC,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAAC,EAAE,GAAW,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;AAClF,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,cAAc;IAGI;IAFZ,KAAK,CAAyB;IAC9B,YAAY,CAAS;IACtC,YAA6B,OAA8B,EAAE;QAAhC,SAAI,GAAJ,IAAI,CAA4B;QAC3D,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,aAAa,CAAC;QACzC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,SAAS,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAY,EAAE,OAA+B,EAAE;QAC7D,IAAI,GAAuB,CAAC;QAC5B,IAAI,OAAO,GAAqB,OAAO,CAAC;QACxC,IAAI,UAAU,GAAG,IAAI,CAAC;QAEtB,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACtB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACnD,IAAI,MAAM,EAAE,CAAC;oBACX,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC;oBAClB,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;oBACzB,UAAU,GAAG,KAAK,CAAC;gBACrB,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,yCAAyC;YAC3C,CAAC;QACH,CAAC;QAED,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,IAAI,CAAC;gBACH,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,IAAI,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;YACtE,CAAC;YAAC,MAAM,CAAC;gBACP,mCAAmC;YACrC,CAAC;QACH,CAAC;QAED,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACvB,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,gDAAgD,CAAC,CAAC;YACnF,CAAC;QACH,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;IACrE,CAAC;CACF"}

package/dist/prompts/local/identify-elements.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Page analysis prompt (identifyElements). New (not from qa-skills).
+ * The vision image is passed as a separate content block; this is the text part.
+ */
+export declare const IDENTIFY_ELEMENTS = "You are an experienced QA engineer. Analyze the web page.\n\nARIA snapshot:\n{{ariaYaml}}\n\nDetected elements (ref \u00B7 role \u00B7 name):\n{{elements}}\n\nTasks:\n1. pageSemantics \u2014 briefly (1\u20132 sentences) describe what this screen is and its main purpose.\n2. primaryRefs \u2014 pick the refs of the most test-worthy elements. Use ONLY refs from the provided\n   list \u2014 do not invent new ones or change them.\n3. viewSwitchers \u2014 refs of view switchers: tabs, wizard steps, filter/mode toggles, form switchers \u2014\n   whose click OPENS DIFFERENT content (rather than performing an action). Only from the provided list; empty if none.\n\nReturn structured output.";
+//# sourceMappingURL=identify-elements.d.ts.map

package/dist/prompts/local/identify-elements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identify-elements.d.ts","sourceRoot":"","sources":["../../../src/prompts/local/identify-elements.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,iBAAiB,srBAeJ,CAAC"}

package/dist/prompts/local/identify-elements.js

@@ -0,0 +1,21 @@
+/**
+ * Page analysis prompt (identifyElements). New (not from qa-skills).
+ * The vision image is passed as a separate content block; this is the text part.
+ */
+export const IDENTIFY_ELEMENTS = `You are an experienced QA engineer. Analyze the web page.
+
+ARIA snapshot:
+{{ariaYaml}}
+
+Detected elements (ref · role · name):
+{{elements}}
+
+Tasks:
+1. pageSemantics — briefly (1–2 sentences) describe what this screen is and its main purpose.
+2. primaryRefs — pick the refs of the most test-worthy elements. Use ONLY refs from the provided
+   list — do not invent new ones or change them.
+3. viewSwitchers — refs of view switchers: tabs, wizard steps, filter/mode toggles, form switchers —
+   whose click OPENS DIFFERENT content (rather than performing an action). Only from the provided list; empty if none.
+
+Return structured output.`;
+//# sourceMappingURL=identify-elements.js.map

package/dist/prompts/local/identify-elements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identify-elements.js","sourceRoot":"","sources":["../../../src/prompts/local/identify-elements.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;0BAeP,CAAC"}

package/dist/prompts/local/index.d.ts

@@ -0,0 +1,3 @@
+/** Local prompts (fallback, ADR-0004). Names match the Langfuse prompt names. */
+export declare const LOCAL_PROMPTS: Record<string, string>;
+//# sourceMappingURL=index.d.ts.map

package/dist/prompts/local/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/prompts/local/index.ts"],"names":[],"mappings":"AAQA,iFAAiF;AACjF,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAQhD,CAAC"}