zerocheck 0.1.7 → 0.1.8

package/README.md

@@ -9,7 +9,7 @@ Paste a checklist, review one drafted check and browser verification result per
 Requires Node.js 20.19 or newer and a Zerocheck project/account. Create a project in the web app’s Settings, then authorize a device or create a project token.
 
 ```sh
-npm install --save-dev --save-exact zerocheck@0.1.7
+npm install --save-dev --save-exact zerocheck@0.1.8
 export ZEROCHECK_API=https://your-instance.example.com
 npx zerocheck login
 npx zerocheck init --project your-project-id --url http://localhost:3000
@@ -155,7 +155,7 @@ Use the installed CLI as a stdio MCP server, with an explicit project directory:
   "mcpServers": {
     "zerocheck": {
       "command": "npx",
-      "args": ["--yes", "zerocheck@0.1.7", "mcp", "--project-dir", "/absolute/path/to/project"]
+      "args": ["--yes", "zerocheck@0.1.8", "mcp", "--project-dir", "/absolute/path/to/project"]
     }
   }
 }
@@ -173,7 +173,7 @@ Local execution sends selected check YAML, the page context needed for AI (inclu
 
 ## Repository development
 
-The CLI bundles the shared engine source into `dist/index.js`; it has no unpublished engine-package dependency. From this repository, run `npm run build`, `npm run check`, and `npm test` in `packages/cli`. Tests include a real MCP client communicating with the bundled CLI over stdio. The generated workflow and documentation use version `0.1.7`; update that pin together with the package version for a release.
+The CLI bundles the shared engine source into `dist/index.js`; it has no unpublished engine-package dependency. From this repository, run `npm run build`, `npm run check`, and `npm test` in `packages/cli`. Tests include a real MCP client communicating with the bundled CLI over stdio. The generated workflow and documentation use version `0.1.8`; update that pin together with the package version for a release.
 
 Hosted runs and imports return a queued handle when browsers are occupied; CLI and MCP keep polling until they finish. The queue holds 20 waiting jobs for up to five minutes and never automatically resumes interrupted jobs after restart. Recent drafts is available in the web app’s Checks page.
 

package/dist/index.js

@@ -7006,7 +7006,7 @@ async function loginCommand() {
   let device;
   try {
     device = await apiRequest("/v1/cli/auth/device", {
-      body: { device_name: deviceName, client_version: "0.1.7" },
+      body: { device_name: deviceName, client_version: "0.1.8" },
       authed: false
     });
   } catch (err) {
@@ -7761,6 +7761,32 @@ import { selectors } from "playwright";
 
 // ../../src/agent/dom-operations.ts
 var facts = {
+  /** Bounded observation preparation, not an authored action. Never scroll a
+   * hidden/clip axis: scrollIntoView would expose intentionally hidden content. */
+  revealForObservation: (target) => {
+    if (!target.isConnected) throw new Error("Text target detached during observation.");
+    const win = target.ownerDocument.defaultView;
+    const ancestors = [];
+    for (let node = target; node; node = node.parentElement ?? node.getRootNode()?.host) {
+      const style = win.getComputedStyle(node);
+      if (style.display === "none" || style.visibility !== "visible" || Number(style.opacity) === 0 || style.contentVisibility === "hidden") return false;
+      ancestors.push(node);
+    }
+    let moved = false;
+    for (const node of ancestors.slice(1)) {
+      if (["HTML", "BODY"].includes(node.tagName)) continue;
+      const style = win.getComputedStyle(node), box = node.getBoundingClientRect(), rect = target.getBoundingClientRect();
+      const left = box.left + node.clientLeft, top = box.top + node.clientTop;
+      const x = rect.left < left ? rect.left - left : Math.max(0, rect.right - left - node.clientWidth);
+      const y = rect.top < top ? rect.top - top : Math.max(0, rect.bottom - top - node.clientHeight);
+      const beforeX = node.scrollLeft, beforeY = node.scrollTop;
+      const scrollX = /^(auto|scroll)$/.test(style.overflowX) && node.scrollWidth > node.clientWidth;
+      const scrollY = /^(auto|scroll)$/.test(style.overflowY) && node.scrollHeight > node.clientHeight;
+      if (scrollX && x || scrollY && y) node.scrollTo({ left: beforeX + (scrollX ? x : 0), top: beforeY + (scrollY ? y : 0), behavior: "instant" });
+      moved ||= node.scrollLeft !== beforeX || node.scrollTop !== beforeY;
+    }
+    return moved;
+  },
   /** Native geometry shared by text and embedded-frame observations. Partial
    * clipping cannot establish a complete text node or a frame's contents. */
   perceptibleBounds: (node, suppliedRect) => {
@@ -7820,7 +7846,20 @@ var facts = {
           const range = doc.createRange();
           range.selectNodeContents(node);
           const rects = Array.from(range.getClientRects());
-          const states = rects.map((rect) => nativeFacts.perceptibleBounds(node.parentElement, rect));
+          const parent = node.parentElement, style = win.getComputedStyle(parent);
+          const lineHeight = parseFloat(style.lineHeight), fontSize = parseFloat(style.fontSize);
+          let plain = rects.length === 1 && parent.childElementCount === 0 && style.writingMode === "horizontal-tb" && style.clip === "auto" && style.clipPath === "none" && lineHeight >= fontSize;
+          for (let owner = parent; plain && owner; owner = owner.parentElement ?? owner.getRootNode()?.host) {
+            const outer = win.getComputedStyle(owner);
+            if (outer.transform !== "none" || outer.zoom !== "1") plain = false;
+          }
+          const box = parent.getBoundingClientRect();
+          const contentTop = box.top + parent.clientTop + parseFloat(style.paddingTop);
+          const contentHeight = parent.clientHeight - parseFloat(style.paddingTop) - parseFloat(style.paddingBottom);
+          const states = rects.map((rect) => nativeFacts.perceptibleBounds(
+            parent,
+            plain && contentHeight >= lineHeight && rect.height >= lineHeight ? { left: rect.left, right: rect.right, top: Math.max(rect.top, contentTop), bottom: Math.min(rect.bottom, contentTop + contentHeight) } : rect
+          ));
           if (states.includes("partial") || states.includes("visible") && states.includes("hidden")) throw new Error("Partly clipped text is inconclusive.");
           if (states.length && states.every((state) => state === "visible")) parts.push(node.textContent);
           return;
@@ -8070,6 +8109,7 @@ var facts = {
     }
     return "";
   },
+  focusWrapper: (element) => element.hasAttribute("tabindex") && !element.isContentEditable && !element.matches('button,a[href],input,select,textarea,summary,[role="button"],[role="link"],[role="checkbox"],[role="radio"],[role="switch"],[role="tab"],[role="menuitem"],[role="menuitemcheckbox"],[role="menuitemradio"],[role="option"],[role="combobox"],[role="textbox"],[role="searchbox"],[role="spinbutton"]') && !element.hasAttribute("onclick"),
   decorations: (element) => {
     const el = element;
     const values = [];
@@ -8135,6 +8175,13 @@ var facts = {
       mutationPossible: false
     };
   },
+  ordinalCollectionLabel: (element) => {
+    const item = element.closest('li,[role="listitem"],tr,[role="row"],[role="option"],[role="treeitem"]');
+    const collection = item?.parentElement?.closest('ol,ul,table,[role="list"],[role="grid"],[role="table"],[role="listbox"],[role="tree"]');
+    if (!collection) return "";
+    const ids = String(collection.getAttribute("aria-labelledby") || "").trim().split(/\s+/).filter(Boolean);
+    return (ids.length ? ids.map((id) => collection.ownerDocument.getElementById(id)?.textContent || "").join(" ") : collection.getAttribute("aria-label") || "").replace(/\s+/g, " ").trim();
+  },
   progressState: (element) => {
     const el = element;
     return {
@@ -8148,30 +8195,70 @@ var facts = {
   progressBoundary: (element) => element.matches('form,article,aside,nav,header,footer,tr,li,[role="form"],[role="dialog"],[role="region"],[role="row"],[role="listitem"],[role="complementary"],[role="navigation"],[role="banner"],[role="contentinfo"],[data-record-id],[data-row-id],[data-entity-id],[data-item-id],[aria-label],[aria-labelledby]'),
   progressView: (scope, _input, nativeFacts) => {
     if (!scope.isConnected) throw new Error("The active view detached during progress observation.");
-    const controls = [];
-    for (const node of scope.querySelectorAll('input:not([type="hidden"],[type="submit"],[type="button"],[type="reset"]),select,textarea,[role="textbox"],[role="combobox"],[role="checkbox"],[role="radio"],[role="switch"]')) {
-      let foreignOwner = false;
+    const unknown2 = { fields: [], fieldless: false, ready: false };
+    const owner = nativeFacts.readiness(scope, { ownSelectAX: false });
+    if (!owner.active || owner.moving) return unknown2;
+    const ownership = { owns(node) {
       for (let parent = node.parentElement; parent && parent !== scope; parent = parent.parentElement) {
-        if (nativeFacts.progressBoundary(parent)) {
-          foreignOwner = true;
-          break;
-        }
+        if (nativeFacts.progressBoundary(parent)) return false;
       }
-      if (foreignOwner) continue;
+      return scope.contains(node);
+    } };
+    const fields = [];
+    let fieldCount = 0;
+    for (const node of scope.querySelectorAll('input:not([type="hidden"],[type="submit"],[type="button"],[type="reset"]),select,textarea,[contenteditable=""],[contenteditable="true" i],[contenteditable="plaintext-only" i],[role="textbox"],[role="searchbox"],[role="spinbutton"],[role="combobox"],[role="checkbox"],[role="radio"],[role="switch"]')) {
+      if (!ownership.owns(node)) continue;
       const readiness = nativeFacts.readiness(node, { ownSelectAX: false });
-      if (readiness.moving) return [];
+      if (readiness.moving) return unknown2;
       if (!readiness.active) continue;
       const visibility = nativeFacts.perceptibleBounds(node);
-      if (visibility === "partial") return [];
+      if (visibility === "partial") return unknown2;
       if (visibility !== "visible") continue;
+      fieldCount++;
       const identity = nativeFacts.identity(node);
-      if (!identity || !identity.name) continue;
-      controls.push(JSON.stringify([identity.role, identity.name.replace(/\s+/g, " ").trim(), identity.inputType]));
+      if (identity?.name) fields.push(JSON.stringify([identity.role, identity.name.replace(/\s+/g, " ").trim(), identity.inputType]));
+    }
+    const headings = [];
+    const status = '[role="alert"],[role="status"],[role="log"],[role="timer"],[role="marquee"],[aria-live]:not([aria-live="off"])';
+    for (const node of scope.querySelectorAll('h1,h2,h3,h4,h5,h6,[role="heading"]')) {
+      if (!ownership.owns(node) || node.parentElement?.closest(status)) continue;
+      const readiness = nativeFacts.readiness(node, { ownSelectAX: false });
+      if (!readiness.active && !readiness.moving) continue;
+      const visibility = nativeFacts.perceptibleBounds(node);
+      if (visibility === "hidden" && !readiness.moving) continue;
+      const eligible = !node.matches(status) && !node.querySelector(status);
+      let text = "", ready = !readiness.moving && visibility === "visible";
+      if (eligible && ready) {
+        try {
+          text = nativeFacts.perceptibleText(node, void 0, nativeFacts).replace(/\s+/g, " ").trim();
+        } catch (error2) {
+          if (error2 instanceof Error && /clipp/.test(error2.message)) ready = false;
+          else throw error2;
+        }
+      }
+      headings.push({ node, level: Number(node.getAttribute("aria-level") || node.localName.match(/^h([1-6])$/)?.[1] || 2), text, eligible, ready });
     }
-    return controls;
+    const labelled = String(scope.getAttribute("aria-labelledby") || "").split(/\s+/).filter(Boolean);
+    const explicit = headings.filter((heading) => labelled.includes(heading.node.id));
+    const principal = labelled.length ? explicit : headings.filter((heading) => heading.level === Math.min(...headings.map((candidate) => candidate.level)));
+    const chosen = principal.length === 1 && principal[0].eligible ? principal[0] : void 0;
+    return { fields, fieldless: fieldCount === 0, ready: chosen?.ready ?? true, ...chosen?.ready && chosen.text ? { heading: chosen.text, headingLevel: chosen.level } : {} };
   }
 };
 var elements = {
+  actionDescendants: (element) => Array.from(element.querySelectorAll('button,a[href],input,select,textarea,summary,[contenteditable],[role="button"],[role="link"],[role="checkbox"],[role="radio"],[role="switch"],[role="tab"],[role="menuitem"],[role="menuitemcheckbox"],[role="menuitemradio"],[role="option"],[role="combobox"],[role="textbox"],[role="searchbox"],[role="spinbutton"],[tabindex],[onclick]')),
+  ordinalItems: (element) => {
+    const itemSelector = 'li,[role="listitem"],tr,[role="row"],[role="option"],[role="treeitem"]';
+    const collectionSelector = 'ol,ul,table,[role="list"],[role="grid"],[role="table"],[role="listbox"],[role="tree"]';
+    const item = element.closest(itemSelector);
+    const collection = item?.parentElement?.closest(collectionSelector);
+    if (!collection) return [];
+    return Array.from(collection.querySelectorAll(itemSelector)).filter((node) => {
+      if (node.parentElement?.closest(collectionSelector) !== collection) return false;
+      for (let parent = node.parentElement; parent && parent !== collection; parent = parent.parentElement) if (parent.matches(itemSelector)) return false;
+      return true;
+    });
+  },
   containingLabel: (control) => control.isConnected ? control.closest("label") : null,
   selects: (root) => {
     if (root.localName === "form") return Array.from(root.elements).filter((node) => node.localName === "select");
@@ -8245,7 +8332,7 @@ var elements = {
     const root = el.getRootNode();
     return form ? Array.from((root.documentElement ?? root).querySelectorAll("button,input")).find((control) => control.form === form && ["submit", "image"].includes(control.type)) ?? null : null;
   },
-  progressScope: (element) => {
+  progressScope: (element, _input, nativeFacts) => {
     if (element.form && !element.form.contains(element)) return element.form;
     let fieldScope = null;
     for (let node = element.parentElement; node && !["BODY", "HTML"].includes(node.tagName); node = node.parentElement) {
@@ -8253,6 +8340,10 @@ var elements = {
       if (node.hasAttribute("aria-label") || node.hasAttribute("aria-labelledby")) return fieldScope ?? node;
       if (node.querySelector(':scope > h1,:scope > h2,:scope > h3,:scope > h4,:scope > [role="heading"],:scope > header > h1,:scope > header > h2,:scope > header > h3')) return fieldScope ?? node;
       if (!fieldScope && node.querySelector('input,select,textarea,[role="textbox"],[role="combobox"],[role="checkbox"],[role="radio"]')) fieldScope = node;
+      if (Array.from(node.querySelectorAll('h1,h2,h3,h4,h5,h6,[role="heading"]')).some((heading) => {
+        for (let parent = heading.parentElement; parent && parent !== node; parent = parent.parentElement) if (nativeFacts.progressBoundary(parent)) return false;
+        return true;
+      })) return fieldScope ?? node;
     }
     return fieldScope;
   },
@@ -8600,7 +8691,11 @@ var TargetProgress = class {
       if (await read(() => signature(handle)) !== prior.signature) return;
       if (prior.scope && await read(() => readDOM(prior.scope, "connected"))) {
         const current = await read(() => readDOM(prior.scope, "progressView"));
-        if (prior.view.some((control) => !current.includes(control)) && current.some((control) => !prior.view.includes(control))) return;
+        if (prior.view.ready && current.ready) {
+          const fieldsChanged = prior.view.fields.some((control) => !current.fields.includes(control)) && current.fields.some((control) => !prior.view.fields.includes(control));
+          const fieldlessTransition = (prior.view.fieldless || current.fieldless) && prior.view.heading && current.heading && prior.view.headingLevel === current.headingLevel && prior.view.heading !== current.heading;
+          if (fieldsChanged || fieldlessTransition) return;
+        }
       }
       await delay(Math.min(50, Math.max(1, deadline - Date.now())), void 0, { signal });
     }
@@ -8611,7 +8706,7 @@ var TargetProgress = class {
     try {
       const scopeValue = await selectDOM(handle, "progressScope");
       scope = scopeValue ?? void 0;
-      return { handle: duplicate, ...scope ? { scope } : {}, signature: await signature(handle), view: scope ? await readDOM(scope, "progressView") : [], lineNumber, entity };
+      return { handle: duplicate, ...scope ? { scope } : {}, signature: await signature(handle), view: scope ? await readDOM(scope, "progressView") : { fields: [], fieldless: false, ready: false }, lineNumber, entity };
     } catch (error2) {
       await duplicate.dispose();
       await scope?.dispose();
@@ -16993,6 +17088,7 @@ async function waitForVisibleText(page, assertion, timeoutMs, signal, targetPoli
           for (let current = frame; current.parentFrame(); current = current.parentFrame()) {
             const owner = await read(() => current.frameElement());
             try {
+              await read(() => readDOM(owner, "revealForObservation"));
               const state = await read(() => readDOM(owner, "perceptibleBounds"));
               if (state === "hidden") {
                 hiddenOwner = true;
@@ -17015,6 +17111,7 @@ async function waitForVisibleText(page, assertion, timeoutMs, signal, targetPoli
             const handle = await read(() => locator.nth(index).elementHandle());
             if (!handle) throw new Error("Text target detached during observation.");
             try {
+              await read(() => readDOM(handle, "revealForObservation"));
               const text = await read(() => readDOM(handle, "perceptibleText"));
               if (assertion.match === "phrase" ? phrasePattern(assertion.text).test(text) : text === assertion.text.replace(/\s+/g, " ").trim()) {
                 found = true;
@@ -17927,7 +18024,13 @@ async function bindIntendedTarget(handle, step, identity, policy) {
   if (!frame) throw new TargetChangedError("Target detached before authored binding.");
   const authored = targetInstruction(step);
   const explicitSelector = explicitRoleTarget(authored.replace(/^(["'])(.*)\1$/, "$2"));
-  const instruction = explicitSelector ? JSON.stringify(explicitSelector.name) : authored;
+  let instruction = explicitSelector ? JSON.stringify(explicitSelector.name) : authored;
+  let tiers;
+  if (hasAuthoredOrdinal(instruction) && literalTargetName(instruction) === void 0) {
+    tiers = await bindingFrames(frame, policy);
+    const whole = normalizeTargetName(instruction);
+    if (await observedLiteralName(tiers, whole, step)) instruction = JSON.stringify(whole);
+  }
   const fullName = normalizeTargetName(instruction);
   const localName = !identity.name && identity.textEntry ? await readDOM(handle, "localLabel") : "";
   const name = (identity.name || localName).trim().replace(/\s+/g, " ").toLowerCase();
@@ -17946,12 +18049,20 @@ async function bindIntendedTarget(handle, step, identity, policy) {
   const role = ["field", "input", "box"].includes(authoredRole ?? "") ? "textbox" : authoredRole === "dropdown" ? "combobox" : authoredRole ?? (step.keyword === "enter" ? "textbox" : step.keyword === "select" ? "combobox" : void 0);
   const clickFamily = !explicitSelector && step.keyword === "click" && ["button", "link"].includes(role ?? "");
   if (!targetRolesMatch(role, identity, clickFamily)) throw new SelectedTargetMismatchError("Ambiguous target: the authored control role does not match.");
-  const authoredName = anchored?.name ?? literalTargetName(qualifier?.rawControl ?? instruction);
+  let authoredName = anchored?.name ?? literalTargetName(qualifier?.rawControl ?? instruction);
+  if (ordinal && authoredName === void 0) {
+    tiers ??= await bindingFrames(frame, policy);
+    if (await observedLiteralName(tiers, control, step, role)) authoredName = control;
+  }
   const literal3 = authoredName !== void 0 || control === name;
-  if (ordinal && !literal3) throw new SelectedTargetMismatchError("The authored ordinal control name does not match.");
+  if (ordinal && !literal3) await assertDescriptiveOrder(handle, ordinal, identity.role, control);
   const controlName = roleOnly ? void 0 : authoredName;
   if (!literal3 && !roleOnly && step.keyword !== "act" && scanQuotedText(instruction).spans.length > 0) throw new SelectedTargetMismatchError("Ambiguous target: the authored control name does not match.");
-  if (!literal3 && !roleOnly && !qualifier) return identity;
+  if (!literal3 && !roleOnly && !qualifier) {
+    const unbound = { ...identity };
+    delete unbound.binding;
+    return unbound;
+  }
   const observedName = authoredName ?? (identity.name.includes("[redacted]") ? (await readTargetIdentity(handle, [], Number.MAX_SAFE_INTEGER)).name : identity.name || localName);
   const escapedName = observedName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
   const queryName = new RegExp(`^[\\s\uE000-\uF8FF\u2190-\u21FF\u27F0-\u27FF\u2900-\u297F]*${escapedName}[\\s\uE000-\uF8FF\u2190-\u21FF\u27F0-\u27FF\u2900-\u297F]*$`, "i");
@@ -17961,28 +18072,7 @@ async function bindIntendedTarget(handle, step, identity, policy) {
   let selected = false;
   let rejected = false;
   let ordered = 0;
-  const primary = [], embedded = [];
-  const requiredFrames = [];
-  for (let current = frame; current; current = current.parentFrame()) requiredFrames.push(current);
-  const topOrigin = policy ? await frameOrigin(frame.page().mainFrame()) : void 0;
-  for (const candidateFrame of policy || anchored ? frame.page().frames() : [frame]) {
-    try {
-      if (!await isFrameVisible(candidateFrame)) continue;
-    } catch (error2) {
-      if (!(error2 instanceof NativeFrameDetachedError)) throw error2;
-      if (requiredFrames.some((required) => required.isDetached())) throw new TargetChangedError("The selected target frame detached before authored binding.");
-      continue;
-    }
-    if (policy && (await blockedFrameOrigins(candidateFrame, policy)).length) continue;
-    let sameChain = true;
-    if (policy) {
-      for (let ancestor = candidateFrame; ancestor; ancestor = ancestor.parentFrame()) if (await frameOrigin(ancestor) !== topOrigin) {
-        sameChain = false;
-        break;
-      }
-    }
-    (sameChain ? primary : embedded).push(candidateFrame);
-  }
+  const [primary, embedded] = tiers ?? await bindingFrames(frame, policy, Boolean(anchored));
   for (const tier of [primary, embedded]) {
     for (const candidateFrame of tier) {
       const nativeRole = ["button", "link", "textbox", "combobox", "checkbox", "radio", "switch", "tab", "menuitem", "menuitemcheckbox", "menuitemradio", "option", "searchbox", "spinbutton", "img"].includes(identity.role);
@@ -18018,6 +18108,7 @@ async function bindIntendedTarget(handle, step, identity, policy) {
           const isSelected = candidateFrame === frame && await candidate.evaluate((element, original) => element === original, handle);
           if (match === "conflict" && !isSelected) continue;
           if (literal3 && !roleOnly && !await nativeNameMatches(candidate, observedName, identity.role, Boolean(identity.textEntry))) continue;
+          if (literal3 && step.keyword === "click" && await isDuplicateFocusWrapper(candidate, observedName)) continue;
           if (match === "conflict") {
             rejected = true;
             continue;
@@ -18076,6 +18167,96 @@ async function nativeNameMatches(handle, expected, role, textEntry) {
   }
   return normalize(name) === normalize(expected);
 }
+async function observedLiteralName(tiers, name, step, role) {
+  if (!name) return false;
+  for (const tier of tiers) for (const frame of tier) {
+    const candidates = await frame.locator('button,a[href],input,select,textarea,summary,[contenteditable],[role="button"],[role="link"],[role="checkbox"],[role="radio"],[role="switch"],[role="tab"],[role="menuitem"],[role="menuitemcheckbox"],[role="menuitemradio"],[role="option"],[role="combobox"],[role="textbox"],[role="searchbox"],[role="spinbutton"],[tabindex],[onclick]').elementHandles();
+    try {
+      for (const candidate of candidates) {
+        if (!(await targetReadiness(candidate)).active) continue;
+        const identity = await readTargetIdentity(candidate);
+        if (step.keyword === "click" && !identity.interactive || step.keyword === "enter" && !identity.textEntry || step.keyword === "select" && identity.role !== "combobox") continue;
+        if (!targetRolesMatch(role, identity, step.keyword === "click" && ["button", "link"].includes(role ?? ""))) continue;
+        if (await nativeNameMatches(candidate, name, identity.role, Boolean(identity.textEntry)) && !await isDuplicateFocusWrapper(candidate, name)) return true;
+      }
+    } finally {
+      await Promise.all(candidates.map((candidate) => candidate.dispose()));
+    }
+  }
+  return false;
+}
+async function focusWrapperWithoutDeclaredActivation(handle) {
+  return await readDOM(handle, "focusWrapper") && !await handle.evaluate((element) => typeof element.onclick === "function");
+}
+async function isDuplicateFocusWrapper(handle, name) {
+  if (!await focusWrapperWithoutDeclaredActivation(handle)) return false;
+  const descendants = await selectAllDOM(handle, "actionDescendants");
+  let matches = 0;
+  try {
+    for (const child of descendants) {
+      if (!(await targetReadiness(child)).active || await focusWrapperWithoutDeclaredActivation(child)) continue;
+      const identity = await readTargetIdentity(child);
+      if (identity.interactive && await nativeNameMatches(child, name, identity.role, Boolean(identity.textEntry))) matches++;
+    }
+    return matches === 1;
+  } finally {
+    await Promise.all(descendants.map((child) => child.dispose()));
+  }
+}
+async function assertDescriptiveOrder(handle, ordinal, role, description) {
+  const label = await readDOM(handle, "ordinalCollectionLabel");
+  if (!label || label.trim().replace(/\s+/g, " ").toLowerCase() !== description) return;
+  const items = await selectAllDOM(handle, "ordinalItems");
+  let count = 0;
+  let selected = 0;
+  try {
+    for (const item of items) {
+      if (!(await targetReadiness(item)).active) continue;
+      const descendants = await selectAllDOM(item, "actionDescendants");
+      const matches = [];
+      try {
+        for (const candidate of [item, ...descendants]) {
+          if (!(await targetReadiness(candidate)).active || await focusWrapperWithoutDeclaredActivation(candidate)) continue;
+          const identity = await readTargetIdentity(candidate);
+          if (identity.role === role && identity.interactive) matches.push(candidate);
+        }
+        if (matches.length !== 1) return;
+        count++;
+        if (await sameDOMNode(matches[0], handle)) selected = count;
+      } finally {
+        await Promise.all(descendants.map((candidate) => candidate.dispose()));
+      }
+    }
+    if (selected && selected !== ordinal) throw new SelectedTargetMismatchError("Ambiguous target: the selected control contradicts the authored ordinal in its collection.");
+  } finally {
+    await Promise.all(items.map((item) => item.dispose()));
+  }
+}
+async function bindingFrames(frame, policy, acrossFrames = false) {
+  const primary = [], embedded = [];
+  const requiredFrames = [];
+  for (let current = frame; current; current = current.parentFrame()) requiredFrames.push(current);
+  const topOrigin = policy ? await frameOrigin(frame.page().mainFrame()) : void 0;
+  for (const candidateFrame of policy || acrossFrames ? frame.page().frames() : [frame]) {
+    try {
+      if (!await isFrameVisible(candidateFrame)) continue;
+    } catch (error2) {
+      if (!(error2 instanceof NativeFrameDetachedError)) throw error2;
+      if (requiredFrames.some((required) => required.isDetached())) throw new TargetChangedError("The selected target frame detached before authored binding.");
+      continue;
+    }
+    if (policy && (await blockedFrameOrigins(candidateFrame, policy)).length) continue;
+    let sameChain = true;
+    if (policy) {
+      for (let ancestor = candidateFrame; ancestor; ancestor = ancestor.parentFrame()) if (await frameOrigin(ancestor) !== topOrigin) {
+        sameChain = false;
+        break;
+      }
+    }
+    (sameChain ? primary : embedded).push(candidateFrame);
+  }
+  return [primary, embedded];
+}
 
 // ../../src/policy/action-safety.ts
 function evaluateActionSafety(input) {
@@ -20924,7 +21105,12 @@ async function draftItem(item, request, options, draftId, earlier = []) {
       const aligned = assertionIndices.length === explicit.length && explicit.every((outcome, index) => {
         const at = assertionIndices[index];
         const proposed = parseStep(steps[at], at + 1);
-        return proposed.keyword === outcome.keyword && equivalentOutcome(normalizeAuthoredOutcome(outcome.argument, outcome.before, steps.slice(0, at)), proposed.argument, outcome.keyword === "wait_for") && (outcome.source.final ? at === steps.length - 1 : checkpointAligned(outcome, steps, at));
+        try {
+          validateOutcomeStep(outcome);
+        } catch {
+          return false;
+        }
+        return proposed.keyword === outcome.keyword && (outcome.source.final ? at === steps.length - 1 : checkpointAligned(outcome, steps, at));
       });
       if (aligned) {
         explicit.forEach((outcome, index) => {
@@ -21017,15 +21203,6 @@ function sourceClauses(text) {
     return { start, boundary, end, raw };
   });
 }
-function equivalentOutcome(expected, proposed, bareText = false) {
-  try {
-    const a = parseVisibleTextAssertion(expected, bareText), b = parseVisibleTextAssertion(proposed, bareText);
-    if (a && b) return JSON.stringify(a) === JSON.stringify(b);
-  } catch {
-    return false;
-  }
-  return expected.replace(/\s+/g, " ").replace(/[.!]$/, "").trim() === proposed.replace(/\s+/g, " ").replace(/[.!]$/, "").trim();
-}
 function actionIdentity(raw) {
   const step = parseStep(raw.replace(/[.!]$/, ""), 0);
   if (step.keyword === "act" || isOutcomeStep(step)) return void 0;
@@ -22243,7 +22420,7 @@ jobs:
           node-version: '22'
       - name: Install Zerocheck
         run: |
-          npm install --prefix "$RUNNER_TEMP/zerocheck-cli" --no-save --package-lock=false zerocheck@0.1.7
+          npm install --prefix "$RUNNER_TEMP/zerocheck-cli" --no-save --package-lock=false zerocheck@0.1.8
           echo "$RUNNER_TEMP/zerocheck-cli/node_modules/.bin" >> "$GITHUB_PATH"
       - name: Restore learned targets
         uses: actions/cache@v4
@@ -28263,7 +28440,7 @@ var runner = z2.enum(["local", "hosted"]).default("local").describe("Local brows
 var output = (value) => ({ content: [{ type: "text", text: JSON.stringify(value) }], structuredContent: { result: value } });
 var error = (value) => ({ isError: true, content: [{ type: "text", text: JSON.stringify({ error: "operation_failed", message: value instanceof Error ? value.message : String(value) }) }] });
 function createMcpServer(services) {
-  const server = new McpServer({ name: "zerocheck", version: "0.1.7" });
+  const server = new McpServer({ name: "zerocheck", version: "0.1.8" });
   server.registerTool("list_checks", {
     description: "List the repository YAML checks, IDs, exact contents and revisions. Does not execute them.",
     inputSchema: { paths: z2.array(z2.string()).optional(), environment },
@@ -28403,7 +28580,7 @@ async function mcpCommand(options) {
 }
 
 // src/index.ts
-var program = new Command().name("zerocheck").version("0.1.7").description("Turn your team\u2019s manual release checklist into repeatable browser tests.");
+var program = new Command().name("zerocheck").version("0.1.8").description("Turn your team\u2019s manual release checklist into repeatable browser tests.");
 var directory = (command) => command.option("--project-dir <path>", "Repository project directory", process.cwd());
 var environment2 = (command) => directory(command).addOption(new Option("--env <environment>", "Named project environment").choices(["dev", "staging", "production"]));
 var execution = (command) => environment2(command).addOption(new Option("--runner <runner>", "Browser execution location").choices(["local", "hosted"]).default("local"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zerocheck",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "Turn manual release checklists into repeatable browser tests locally, in CI, or hosted.",
   "type": "module",
   "repository": {