@enricai/barnacle 1.9.7 → 1.9.9

package/dist/scraper/flow-runner.js

@@ -149,7 +149,7 @@ function wireSignalCapture(page, params) {
     // See mergeResponseHeaders.
     const extraResponseHeaders = new Map();
     // Cookie (and other extra-info-only request headers) keyed by requestId.
-    // Mirrors extraResponseHeaders: Network.requestWillBeSent omits the outgoing
+    // Parallels extraResponseHeaders: Network.requestWillBeSent omits the outgoing
     // Cookie header by design, and requestWillBeSentExtraInfo — which carries it —
     // can race requestWillBeSent in either order. Buffered here and folded into
     // the capture once, in `onFinished`. See mergeResponseHeaders.
@@ -691,7 +691,7 @@ const ADVANCE_STEP_PHRASES = [
  * advance step must be verified by a real transition (network/URL), not a DOM
  * state change. Keyed on the ORIGINAL step instruction so a rephrase that
  * resolves "Next" to a radio click can't launder a field toggle into a passed
- * advance. Pure; unit-testable seam mirroring `isWizardExitAction`.
+ * advance. Pure; unit-testable seam paralleling `isWizardExitAction`.
  */
 function isAdvanceStep(instruction) {
     if (!instruction)
@@ -1704,7 +1704,7 @@ async function extractLivePageFormEvidence(_page, target, options) {
  * signals" — DOM tree walking is the latter.
  *
  * Returns up to 12 leaf records. Empty array on evaluate failure (safe
- * fallback to the existing Haiku judge upstream). The `inputTag` and
+ * fallback to the existing Haiku judge earlier in the pipeline). The `inputTag` and
  * `visibleErrorText` fields let the prompt distinguish a smart-address
  * autocomplete (where typing-only fails and the cascade needs dropdown
  * selection) from a plain text input.
@@ -2254,7 +2254,7 @@ function isCommittedDateReadback(readback) {
  * The committed value is confirmed via {@link verifyFillReadback}; a datepicker
  * reformats what it accepts, so a non-empty date-shaped readback is success.
  *
- * Return contract mirrors {@link fillHtml5DateTimeInput}: `null` means "not a
+ * Return contract parallels {@link fillHtml5DateTimeInput}: `null` means "not a
  * datepicker — caller falls through to the generic readback verifier"; a
  * non-null object means "this WAS a datepicker, here's the outcome". A non-null
  * `filled:false` therefore deliberately TERMINATES the cascade (the caller
@@ -2295,7 +2295,7 @@ async function fillTextDatepickerInput(target, selector, value) {
     catch {
         return null;
     }
-    // Strategy 1 — keyboard entry (typeable datepickers). Mirrors the Angular
+    // Strategy 1 — keyboard entry (typeable datepickers). Parallels the Angular
     // reactive-form re-type at verifyDomEffect: real CDP keystrokes flow through
     // the widget's own onChange, unlike a programmatic value write.
     const typed = (0, date_fns_1.format)(new Date(parts.year, parts.monthIndex, parts.day), "MM/dd/yyyy");
@@ -2804,8 +2804,8 @@ async function surfaceAndUpload(params) {
     // mount. Wait (bounded, same window as the raw-input probe) for ANY upload
     // target to appear — a dropzone, an upload-affordance button, or an
     // <input type=file> — so every downstream strategy runs against a rendered
-    // widget. Static evaluate literal (no interpolation); dropzone list mirrors
-    // simulateDragDropUpload and the button matcher mirrors clickUploadAffordance.
+    // widget. Static evaluate literal (no interpolation); dropzone list parallels
+    // simulateDragDropUpload and the button matcher parallels clickUploadAffordance.
     const targetExpr = `(() => {
     const norm = (s) => (s || "").replace(/\\s+/g, " ").trim().toLowerCase();
     const isUpload = (raw) => {
@@ -2917,7 +2917,7 @@ async function surfaceAndUpload(params) {
  * (the frame the enumerate/click runs against).
  */
 async function clickUploadAffordance(page, target, logger) {
-    // The browser-side matcher mirrors isUploadAffordanceLabel; kept as a literal
+    // The browser-side matcher parallels isUploadAffordanceLabel; kept as a literal
     // so the enumerate is a static string (same trust posture as the other
     // primitives). No external interpolation.
     const expr = `(() => {
@@ -3080,7 +3080,7 @@ function parseFillStep(instruction) {
  * "Type '01/2020' into the Start Date input", which carries no `fill` verb, so
  * without the `type` shape the guard could never fire on any replanned step.
  *
- * Deliberately excludes select steps (checked first, mirroring
+ * Deliberately excludes select steps (checked first, paralleling
  * `resolveDeepLocatorActuation`'s precedence) so a `select '…'` step whose
  * prose happens to trail a quoted value is never mistaken for a fill. Returns
  * `null` for clicks, selects, and any step without a quoted value.
@@ -3518,7 +3518,7 @@ const DECLINE_OPTION_MARKERS = [
 ];
 /**
  * Pick an option to satisfy a REQUIRED select on a catch-all step, from the
- * select's option TEXTS (placeholder already excluded upstream). Policy: take
+ * select's option TEXTS (placeholder already excluded earlier). Policy: take
  * the first non-decline option (a plausible substantive answer — the operator
  * accepts LLM-plausible answers reaching ATS prod); fall back to the first
  * option only if every option is a decline/placeholder. Returns null when there
@@ -4518,7 +4518,7 @@ async function verifyDomEffect(target, action) {
             case "selectOptionFromDropdown": {
                 // Stagehand dispatches both names to Playwright's `locator.selectOption(text)`,
                 // which only succeeds on native <select> and matches the input against any of
-                // the option's value/label/textContent. Mirror that resolution at verify time
+                // the option's value/label/textContent. Match that resolution at verify time
                 // so we get a real equality signal — Playwright's "selection happened" succeeds
                 // iff one of those three fields matches.
                 const expected = action.arguments?.[0]?.toString().trim() ?? "";
@@ -4536,7 +4536,7 @@ async function verifyDomEffect(target, action) {
                 // UI-style widgets — always fail the native-<select>-only check below,
                 // misreporting genuinely-successful selections as unverified. Fall back to
                 // reading the combobox's own displayed/aria value when the resolved element
-                // isn't a real <select>, mirroring what a real ARIA combobox exposes.
+                // isn't a real <select>, paralleling what a real ARIA combobox exposes.
                 const exprNative = `(() => { const r = document.evaluate(${JSON.stringify(xpath)}, document, null, XPathResult.FIRST_ORDERED_NODE_TYPE, null); const el = r.singleNodeValue; if (!el || el.tagName !== "SELECT") return null; const opt = el.options[el.selectedIndex]; if (!opt) return { value: "", label: "", text: "" }; return { value: (opt.value || "").trim(), label: (opt.label || "").trim(), text: (opt.textContent || "").trim() }; })()`;
                 let selected = null;
                 try {
@@ -4597,7 +4597,7 @@ async function verifyDomEffect(target, action) {
             }
             case "setInputFiles":
                 // No cheap DOM equivalent without re-resolving the file. Trust Stagehand's
-                // actResultSuccess upstream — caller composes signals.
+                // actResultSuccess from the caller — caller composes signals.
                 return true;
             case "click": {
                 // Clicks on radios and checkboxes toggle `:checked` without firing a
@@ -5812,7 +5812,7 @@ async function executeStepWithHealing(params) {
                     // `-32000 Node does not have a layout object` error (an unrendered
                     // node) or is refused by the wizard-exit deny-list costs only that
                     // one candidate, not the whole attempt — the next ranked candidate
-                    // is tried instead. `attemptTriedSelectors` mirrors the walk's own
+                    // is tried instead. `attemptTriedSelectors` parallels the walk's own
                     // click attempts as they happen (not just on a successful return)
                     // so a click that throws a REAL error (e.g. a wedged
                     // `WatchdogTimeoutError`) still feeds attempt 4's exclusion filter.
@@ -6230,7 +6230,7 @@ async function executeStepWithHealing(params) {
                         ? await deepLocatorCandidatesAsActions(page, frameTarget, step)
                         : observedCandidates;
                     // Fetch live-page evidence so the rephrase prompt can reason about
-                    // form state, not just observe candidates. Mirrors the same
+                    // form state, not just observe candidates. Parallels the same
                     // extraction the cascade-exhaust dump path already does.
                     const livePageEvidence = await extractLivePageFormEvidence(page, frameTarget ?? (0, frame_target_1.mainFrameTarget)(page), {
                         client: anthropic,
@@ -6675,7 +6675,7 @@ async function executeStepWithHealing(params) {
                     // (validation errors rendered) with NO network/URL change is a
                     // validation-blocked no-op, not a real transition — but the
                     // dom-delta/text-change signals below would score it verified and
-                    // advance the wizard past an unfilled required page. Mirror the
+                    // advance the wizard past an unfilled required page. Match the
                     // checkbox vacuous-click guard: when a click produced no network/URL
                     // change AND the page still has required-invalid controls (MUI-aware
                     // via countNgInvalidContainers), treat the DOM-only signal as NOT
@@ -6997,7 +6997,7 @@ async function executeStepWithHealing(params) {
     }
     throw new errors_2.StepVerificationError(`${formatStepPrefix(stepIndex, totalSteps)} (${step.slice(0, 60)}) failed verification after ${MAX_STEP_ATTEMPTS} attempts${dumpPath ? `; see ${dumpPath}` : ""}`, phantomClickAfterAttempt1 ? "phantom-click-exhausted" : "cascade-exhausted");
 }
-/** SPA-readiness gate defaults — mirror the recon CLI's post-navigation wait. */
+/** SPA-readiness gate defaults — match the recon CLI's post-navigation wait. */
 const SPA_READINESS_TIMEOUT_MS = 15_000;
 const SPA_READINESS_POLL_MS = 500;
 const SPA_MIN_BODY_LENGTH = 5_000;
@@ -7101,7 +7101,7 @@ async function runHealingFlow(deps) {
             // Resolved fresh per step (not cached across the run) so a cross-origin
             // iframe that attaches mid-flow (e.g. after an "Apply" click reveals a
             // wizard embedded later in the DOM) is picked up as soon as it's
-            // reachable, mirroring the recon CLI's per-step resolution. `resolveFrameTarget`
+            // reachable, paralleling the recon CLI's per-step resolution. `resolveFrameTarget`
             // falls back to the main-frame target when `frameSelector` is null/unresolvable,
             // so this is a no-op for every flow that doesn't declare one.
             const frameTarget = await (0, frame_target_1.resolveFrameTarget)(page, deps.frameSelector);