@enricai/barnacle 1.10.0 → 1.11.0

package/dist/scraper/phantom-click.d.ts

@@ -11,28 +11,24 @@ export interface PhantomClickSnapshot {
     url: string;
     /** `document.body.outerHTML.length`. */
     bodyHtmlLength: number;
-    /**
-     * Fingerprint of client-side selection state across selection-bearing
-     * controls — `aria-pressed`/`aria-checked`/`aria-selected`, `data-state`
-     * (excluding `open`/`closed` disclosure values), `data-selected`/
-     * `data-checked`, and a selected/active/checked class-token hit on an
-     * interactive element. A multi-select toggle (React state flip) moves this
-     * without moving network, URL, or byte size — often a NEGATIVE byte delta
-     * (an `aria-pressed="false"`→`"true"` flip shrinks the HTML), which the
-     * byte-floor branch can never catch. A pure `disabled`→`enabled` gate with
-     * no accompanying selection-marker change is intentionally NOT tracked.
-     * Optional so pre-`selectionStateSignature` snapshots (and this module's own
-     * tests) stay valid; a defined pre/post pair that differs is a real effect
-     * (see {@link classifyPhantomClick}). The producer is `snapshotPage`'s
-     * `DOM_SNAPSHOT_EXPR` in `flow-runner.ts`, which documents the exact shape.
-     */
-    selectionStateSignature?: string;
 }
 export interface PhantomClickAttempt {
     /** Stagehand's own verdict for the attempt — did it believe it acted? */
     actResultSuccess: boolean | null;
     pre: PhantomClickSnapshot;
     post: PhantomClickSnapshot;
+    /**
+     * True when the resolved element's OWN committed selection state changed
+     * across the click — the authoritative, element-scoped signal `verifyDomEffect`
+     * computes from the pre/post per-element fingerprint baseline
+     * (`StepSnapshot.selectionStateByXpath`). A design-system option/toggle (Base
+     * Web `kind` flip, hashed-class swap, ARIA, native `checked`) registers here
+     * with no network, no URL change, and a trivial/negative byte delta that the
+     * byte-floor branch can never catch. Element-scoped, so a state change on any
+     * OTHER element on the page can never lift this verdict off `phantom`.
+     * Optional so callers/tests that don't supply it default to `false`.
+     */
+    elementStateChanged?: boolean;
     /**
      * True when the step is submit-shaped (a final/submit click). A submit must
      * show a REAL effect (network/URL) to count as effective — a mere selection-

package/dist/scraper/phantom-click.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"phantom-click.d.ts","sourceRoot":"","sources":["../../src/scraper/phantom-click.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,qFAAqF;AACrF,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,wCAAwC;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB;;;;;;;;;;;;;;OAcG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,mBAAmB;IAClC,yEAAyE;IACzE,gBAAgB,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,GAAG,EAAE,oBAAoB,CAAC;IAC1B,IAAI,EAAE,oBAAoB,CAAC;IAC3B;;;;;;;;OAQG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,MAAM,mBAAmB;AAC7B,0FAA0F;AACxF,SAAS;AACX,mEAAmE;GACjE,WAAW;AACb,kKAAkK;GAChK,YAAY,CAAC;AAEjB;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,mBAAmB,GAAG,mBAAmB,CA2BtF"}
+{"version":3,"file":"phantom-click.d.ts","sourceRoot":"","sources":["../../src/scraper/phantom-click.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,qFAAqF;AACrF,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,wCAAwC;IACxC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,yEAAyE;IACzE,gBAAgB,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,GAAG,EAAE,oBAAoB,CAAC;IAC1B,IAAI,EAAE,oBAAoB,CAAC;IAC3B;;;;;;;;;;OAUG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;;;;;OAQG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,MAAM,mBAAmB;AAC7B,0FAA0F;AACxF,SAAS;AACX,mEAAmE;GACjE,WAAW;AACb,kKAAkK;GAChK,YAAY,CAAC;AAEjB;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,mBAAmB,GAAG,mBAAmB,CAuBtF"}

package/dist/scraper/phantom-click.js

@@ -31,22 +31,19 @@ function classifyPhantomClick(attempt) {
     const networkDelta = attempt.post.networkCount - attempt.pre.networkCount;
     const bytesDelta = attempt.post.bodyHtmlLength - attempt.pre.bodyHtmlLength;
     const urlChanged = attempt.post.url !== attempt.pre.url;
-    // A client-side selection toggle (aria-pressed/checked/selected, data-state,
-    // or a selected/active/checked class) is a real effect regardless of byte
-    // size — the byte floor below rejects it because the delta is trivial or
-    // negative. Only credit when BOTH signatures are defined (an older snapshot
-    // without the field mustn't read undefined === undefined as a change) and
-    // they differ. NOT on a submit-shaped step: a submit must prove itself via
-    // network/URL, and letting a stray selection flip mark it "effective" would
-    // defeat the cascade's phantom-verdict-driven escalation to the deep submit
-    // locator.
-    const selectionStateChanged = !attempt.isSubmitShapedStep &&
-        attempt.pre.selectionStateSignature !== undefined &&
-        attempt.post.selectionStateSignature !== undefined &&
-        attempt.pre.selectionStateSignature !== attempt.post.selectionStateSignature;
+    // The resolved element's OWN committed selection state changed across the
+    // click — a design-system option/toggle (Base Web `kind` flip, hashed-class
+    // swap, ARIA, native `checked`) registers here with no network, no URL, and a
+    // trivial/negative byte delta the byte floor can never catch. Authoritative
+    // and element-scoped (`verifyDomEffect` read it off the clicked element, not a
+    // page-wide fingerprint), so an unrelated element's change can't fake it. NOT
+    // on a submit-shaped step: a submit must prove itself via network/URL, or the
+    // cascade's phantom-verdict-driven escalation to the deep submit locator would
+    // be defeated by a stray self-toggle on the submit button.
+    const elementStateChanged = !attempt.isSubmitShapedStep && attempt.elementStateChanged === true;
     const hasEffect = networkDelta !== 0 ||
         urlChanged ||
-        selectionStateChanged ||
+        elementStateChanged ||
         bytesDelta >= exports.TRIVIAL_DOM_DELTA_BYTES;
     return hasEffect ? "effective" : "phantom";
 }

package/dist/scraper/phantom-click.js.map

@@ -1 +1 @@
-{"version":3,"file":"phantom-click.js","sourceRoot":"","sources":["../../src/scraper/phantom-click.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;AAmDH;;;;;;GAMG;AACU,QAAA,uBAAuB,GAAG,GAAG,CAAC;AAE3C;;;;;;;GAOG;AACH,8BAAqC,OAA4B;IAC/D,IAAI,OAAO,CAAC,gBAAgB,KAAK,IAAI;QAAE,OAAO,YAAY,CAAC;IAE3D,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IAC1E,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAC5E,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;IACxD,6EAA6E;IAC7E,0EAA0E;IAC1E,yEAAyE;IACzE,4EAA4E;IAC5E,0EAA0E;IAC1E,2EAA2E;IAC3E,4EAA4E;IAC5E,4EAA4E;IAC5E,WAAW;IACX,MAAM,qBAAqB,GACzB,CAAC,OAAO,CAAC,kBAAkB;QAC3B,OAAO,CAAC,GAAG,CAAC,uBAAuB,KAAK,SAAS;QACjD,OAAO,CAAC,IAAI,CAAC,uBAAuB,KAAK,SAAS;QAClD,OAAO,CAAC,GAAG,CAAC,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,uBAAuB,CAAC;IAE/E,MAAM,SAAS,GACb,YAAY,KAAK,CAAC;QAClB,UAAU;QACV,qBAAqB;QACrB,UAAU,IAAI,QAAA,uBAAuB,CAAC;IACxC,OAAO,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"phantom-click.js","sourceRoot":"","sources":["../../src/scraper/phantom-click.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;AA+CH;;;;;;GAMG;AACU,QAAA,uBAAuB,GAAG,GAAG,CAAC;AAE3C;;;;;;;GAOG;AACH,8BAAqC,OAA4B;IAC/D,IAAI,OAAO,CAAC,gBAAgB,KAAK,IAAI;QAAE,OAAO,YAAY,CAAC;IAE3D,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IAC1E,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAC5E,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;IACxD,0EAA0E;IAC1E,4EAA4E;IAC5E,8EAA8E;IAC9E,4EAA4E;IAC5E,+EAA+E;IAC/E,8EAA8E;IAC9E,8EAA8E;IAC9E,+EAA+E;IAC/E,2DAA2D;IAC3D,MAAM,mBAAmB,GAAG,CAAC,OAAO,CAAC,kBAAkB,IAAI,OAAO,CAAC,mBAAmB,KAAK,IAAI,CAAC;IAEhG,MAAM,SAAS,GACb,YAAY,KAAK,CAAC;QAClB,UAAU;QACV,mBAAmB;QACnB,UAAU,IAAI,QAAA,uBAAuB,CAAC;IACxC,OAAO,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7C,CAAC"}

package/dist/scripts/recon-generate.js

@@ -2293,10 +2293,10 @@ function deriveProducerBoundaryBindings(actions, alreadyBound) {
  *
  * WHY before {@link interpolateStateValues} and not via its payload pass: a
  * composite coordinate like a jobLocation `"Torrington, Connecticut, United
- * States"` or a jobSeqNo `"HHKHHEUS26158515EXTERNALENUS"` contains inner tokens a
+ * States"` or a jobSeqNo `"AAA0000000000EXTERNALENUS"` contains inner tokens a
  * genuinely-prior step produces as its own state var (a `label`, a `refNum`).
  * Pass-1 state threading would fragment the string (`"Torrington, ${label}"`,
- * `"${refNum}26158515EXTERNALENUS"`) before the length-descending payload pass
+ * `"${refNum}0000000000EXTERNALENUS"`) before the length-descending payload pass
  * could match the full literal — and the collision guard then refuses to bind the
  * embedded remainder, stranding it frozen. Binding the whole coordinate first —
  * the same "swallow whole before inner passes reach in" discipline as

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enricai/barnacle",
-  "version": "1.10.0",
+  "version": "1.11.0",
   "description": "Site-agnostic browser automation engine. POST a structured payload to a typed endpoint; Barnacle drives a Steel + Stagehand session through the target site and returns a structured result.",
   "license": "MIT",
   "author": "Enricai",