@enricai/barnacle 1.9.8 → 1.9.10

package/README.md

@@ -139,7 +139,7 @@ Each file is a JSON object:
 }
 ```
 
-Field reference (mirrors CDP's `Network.Cookie` type verbatim — no remapping between capture and disk):
+Field reference (matches CDP's `Network.Cookie` type verbatim — no remapping between capture and disk):
 
 | Field | Meaning |
 | --- | --- |
@@ -328,7 +328,7 @@ interface SitePlugin<TPayload, TResult> {
 | `maxAttempts?` | `number` | Override the retry policy's default of 3 attempts (including the first try). Without this, the per-run ceiling is `3 × taskTimeoutMs`; set to `1` so `taskTimeoutMs` is the real per-run cap |
 | `apiVersion?` | `string` | Semver range targeting a plugin API version (e.g. `"^1.0.0"`); core disables the plugin on a major-version mismatch. Absent means "accept any version." |
 | `extraRoutes?` | `readonly SitePluginExtraRoute[]` | Extra non-run routes (OTP trigger, resume, etc.) that core registers as authenticated Fastify routes at startup. See `SitePluginExtraRoute` in `src/site-plugin.ts`. |
-| `onShutdown?` | `() => Promise<void>` | Optional cleanup for background work the plugin launched fire-and-forget, awaited during graceful shutdown so in-flight work is not abandoned and sessions are not leaked. Mirrors the engine's own drain functions. Bounded by a per-plugin timeout, so a hanging drain cannot stall shutdown. Module plugins only — config-only `*.plugin.json` manifests are pure JSON and cannot declare a function. |
+| `onShutdown?` | `() => Promise<void>` | Optional cleanup for background work the plugin launched fire-and-forget, awaited during graceful shutdown so in-flight work is not abandoned and sessions are not leaked. Parallels the engine's own drain functions. Bounded by a per-plugin timeout, so a hanging drain cannot stall shutdown. Module plugins only — config-only `*.plugin.json` manifests are pure JSON and cannot declare a function. |
 
 ### Full plugin skeleton (hot path + browser fallback)
 
@@ -623,7 +623,7 @@ When the smoke test fails: re-run `pnpm run recon:browser` → diff `<run-dir>/g
 
 ### Cache deduplication
 
-`getCachedResponse()` checks the LRU cache first. On a miss, `getOrCreateInFlight()` registers a promise in an `inFlight` map before awaiting it — meaning concurrent identical requests all await the same upstream call rather than fanning out. First caller wins; all others coalesce onto its promise.
+`getCachedResponse()` checks the LRU cache first. On a miss, `getOrCreateInFlight()` registers a promise in an `inFlight` map before awaiting it — meaning concurrent identical requests all await the same origin call rather than fanning out. First caller wins; all others coalesce onto its promise.
 
 Cache key: `<endpoint>:<sha256(canonical payload)[:32]>` — the endpoint is a literal prefix; the hash covers only the canonical payload. Object key order and primitive array element order are normalized so `{a:1,b:2}` and `{b:2,a:1}` hit the same entry. Default TTL: 15 minutes (`CACHE_TTL_MS`). Max entries: 1000 (`CACHE_MAX_ENTRIES`). Only successful responses are cached; errors propagate and never poison the cache.
 
@@ -694,7 +694,7 @@ When using Anthropic directly (not Bedrock), the model is controlled by `STAGEHA
 
 **What rising `fallbackActivations` means:** the hot path is failing and the browser fallback is absorbing traffic. Cost and latency rise while error rate stays flat — users don't notice yet, but you will on your bill. This is your signal to re-run recon.
 
-**`p95LatencyMs`** is reservoir-sampled (Vitter's Algorithm R, capped at 1000 samples) over actual upstream round-trips. Cache hits are excluded — they're memory reads and must not bias the upstream latency signal.
+**`p95LatencyMs`** is reservoir-sampled (Vitter's Algorithm R, capped at 1000 samples) over actual origin round-trips. Cache hits are excluded — they're memory reads and must not bias the origin latency signal.
 
 See [docs/playbook.md](./docs/playbook.md#6b--metrics-signals-the-detection-ladder) for the full detection ladder.
 
@@ -916,7 +916,7 @@ http/net/dns. Metrics have no such constraint.
 | `SUBMISSIONS_NDJSON_PATH` | `.barnacle/submissions.ndjson` | Append-only NDJSON sink for dispatch submission envelopes and beacon-fire outcomes. `kind:"submit"` lines (null/`"submit"`-defaulted on legacy lines) capture siteId, requestId, inbound payload, status, audit payload, and duration, plus the opaque `joinKeys` bag a plugin's `extractJoinKeys` hook resolved, merged with anything attached mid-run via `context.telemetry.addJoinKeys()` — the durable source-of-truth for "what did we submit for jobId X and did it succeed." `kind:"beacon"` lines record a later (or, for `beaconStatus: "skipped"`, immediate) independent beacon-fire outcome (`beaconStatus`: `fired`/`failed`/`skipped`, truncated `trackingUrl`) for the same `requestId`, so "submitted but the beacon did not fire" is measurable — the `skipped` line is always written by `dispatch()` itself, but a plugin managing its own tracking nav can call `context.recordBeaconOutcome` to append a real `fired`/`failed` line for the same `requestId`, which outranks `skipped` when the two are folded (see [Reconciliation join keys](#reconciliation-join-keys-extractjoinkeys)). A reader folds both kinds together by `requestId`, so a plugin can join runs to its own attribution provider's report without re-parsing `inboundPayload`. |
 | `TELEMETRY_MAX_FILE_SIZE_BYTES` | `104857600` (100 MB) | Rotate/drop the calls NDJSON once it exceeds this byte count. |
 | `TELEMETRY_MAX_RETENTION_MS` | `2592000000` (30 days) | Drop event-stream files older than this many milliseconds. |
-| `TELEMETRY_S3_BUCKET` | — | Optional — destination bucket for the buffered S3 telemetry mirror. Sink is entirely inert (no client, no network calls) when unset. Credentials/region resolve the same way as Bedrock (`AWS_REGION`, standard SDK credential order). |
+| `TELEMETRY_S3_BUCKET` | — | Optional — destination bucket for the buffered S3 telemetry replica. Sink is entirely inert (no client, no network calls) when unset. Credentials/region resolve the same way as Bedrock (`AWS_REGION`, standard SDK credential order). |
 | `TELEMETRY_S3_PREFIX` | `telemetry` | Key prefix for uploaded NDJSON objects (`<prefix>/<calls\|submissions>/<date>/...`). |
 | `TELEMETRY_S3_FLUSH_INTERVAL_MS` | `60000` | How often buffered lines are flushed to S3. |
 | `TELEMETRY_S3_MAX_BUFFER_LINES` | `500` | Threshold-flush trigger — flush early if either buffer exceeds this many lines, ahead of the next scheduled interval. |
@@ -1065,7 +1065,7 @@ Every response — success or error — uses the same envelope shape so clients
 | 2005 | `EMPTY_RESULTS` | Scrape succeeded but returned no data |
 | 2006 | `VERIFICATION_TRIGGER_FAILED` | OTP trigger to the target site failed |
 | 2007 | `RESUME_INVALID_OTP` | Provided OTP was rejected by the target site |
-| 2008 | `URL_LOCKED` | Upstream vendor locked the target URL; back off and retry later |
+| 2008 | `URL_LOCKED` | Target site locked the target URL; back off and retry later |
 
 Full definitions: `src/api/schemas/common.ts`.
 

package/dist/api/errors.d.ts

@@ -54,7 +54,7 @@ export declare class ThrottledRequestError extends ApiError {
     constructor(message?: string);
 }
 /**
- * The upstream site has locked the target URL (a plugin raises the underlying
+ * The target site has locked the target URL (a plugin raises the underlying
  * `HttpUrlLockedError`, e.g. from a `classifyResponseBody` sentinel).
  * Signals "back off and retry later" — not a browser-fallback trigger.
  */

package/dist/api/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/api/errors.ts"],"names":[],"mappings":"AAGA,OAAO,EAAwC,KAAK,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAE5F;;;;GAIG;AACH,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,gBAAgB;IACxB,MAAM,EAAE;QACN,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,eAAe,EAAE,CAAC;KAC5B,CAAC;CACH;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAgCzD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQvD;AAED;;;;GAIG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,IAAI,EAAE,SAAS,CAAC;IAChC,SAAgB,UAAU,EAAE,MAAM,CAAC;IAEnC,YAAY,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,SAAU,EAKjE;CACF;AAED,qBAAa,iBAAkB,SAAQ,QAAQ;IAC7C,YAAY,OAAO,SAA4C,EAE9D;CACF;AAED,qBAAa,mBAAoB,SAAQ,QAAQ;IAC/C,YAAY,OAAO,EAAE,MAAM,EAE1B;CACF;AAED,qBAAa,qBAAsB,SAAQ,QAAQ;IACjD,YAAY,OAAO,SAAwB,EAE1C;CACF;AAED;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,YAAY,OAAO,SAA2D,EAE7E;CACF;AAED,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C,YAAY,OAAO,SAA0C,EAE5D;CACF;AAED,qBAAa,uBAAwB,SAAQ,QAAQ;IACnD,YAAY,OAAO,SAA2C,EAE7D;CACF;AAED,qBAAa,oBAAqB,SAAQ,QAAQ;IAChD,YAAY,OAAO,SAA6C,EAE/D;CACF;AAED;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;IAC3C,YAAY,OAAO,SAAiD,EAEnE;CACF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,EACf,UAAU,SAAU,GACnB,gBAAgB,CAgBlB"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/api/errors.ts"],"names":[],"mappings":"AAGA,OAAO,EAAwC,KAAK,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAE5F;;;;GAIG;AACH,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,gBAAgB;IACxB,MAAM,EAAE;QACN,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,eAAe,EAAE,CAAC;KAC5B,CAAC;CACH;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAgCzD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQvD;AAED;;;;GAIG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,IAAI,EAAE,SAAS,CAAC;IAChC,SAAgB,UAAU,EAAE,MAAM,CAAC;IAEnC,YAAY,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,SAAU,EAKjE;CACF;AAED,qBAAa,iBAAkB,SAAQ,QAAQ;IAC7C,YAAY,OAAO,SAA4C,EAE9D;CACF;AAED,qBAAa,mBAAoB,SAAQ,QAAQ;IAC/C,YAAY,OAAO,EAAE,MAAM,EAE1B;CACF;AAED,qBAAa,qBAAsB,SAAQ,QAAQ;IACjD,YAAY,OAAO,SAAwB,EAE1C;CACF;AAED;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,YAAY,OAAO,SAAyD,EAE3E;CACF;AAED,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C,YAAY,OAAO,SAA0C,EAE5D;CACF;AAED,qBAAa,uBAAwB,SAAQ,QAAQ;IACnD,YAAY,OAAO,SAAqD,EAEvE;CACF;AAED,qBAAa,oBAAqB,SAAQ,QAAQ;IAChD,YAAY,OAAO,SAA6C,EAE/D;CACF;AAED;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;IAC3C,YAAY,OAAO,SAAiD,EAEnE;CACF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,EACf,UAAU,SAAU,GACnB,gBAAgB,CAgBlB"}

package/dist/api/errors.js

@@ -100,12 +100,12 @@ class ThrottledRequestError extends ApiError {
 }
 exports.ThrottledRequestError = ThrottledRequestError;
 /**
- * The upstream site has locked the target URL (a plugin raises the underlying
+ * The target site has locked the target URL (a plugin raises the underlying
  * `HttpUrlLockedError`, e.g. from a `classifyResponseBody` sentinel).
  * Signals "back off and retry later" — not a browser-fallback trigger.
  */
 class UrlLockedError extends ApiError {
-    constructor(message = "target URL is locked by the upstream site; retry later") {
+    constructor(message = "target URL is locked by the target site; retry later") {
         super(common_1.ERROR_CODES.URL_LOCKED, message);
     }
 }
@@ -117,7 +117,7 @@ class ScrapeFailureError extends ApiError {
 }
 exports.ScrapeFailureError = ScrapeFailureError;
 class CaptchaEncounteredError extends ApiError {
-    constructor(message = "captcha challenge encountered upstream") {
+    constructor(message = "captcha challenge encountered on the target site") {
         super(common_1.ERROR_CODES.CAPTCHA_ENCOUNTERED, message);
     }
 }

package/dist/api/errors.js.map

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

package/dist/api/plugins/error-handler.js

@@ -45,7 +45,7 @@ async function errorHandlerPlugin(app) {
         // exhausted selector retries, session timeouts) surface to clients as
         // the dedicated codes 2004 / 2003 rather than a generic 1008 — the
         // whole reason those codes exist is for clients to distinguish scrape
-        // failures from upstream target-site failures.
+        // failures from target-site failures.
         if ((0, errors_2.isScraperError)(error)) {
             const code = (0, errors_2.isCaptchaError)(error)
                 ? common_1.ERROR_CODES.CAPTCHA_ENCOUNTERED

package/dist/api/plugins/error-handler.js.map

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

package/dist/api/routes/submissions.d.ts

@@ -1,7 +1,7 @@
 import type { FastifyInstance } from "fastify";
 /**
  * Injectable options for `submissionsRoutes`. The sink path is passed in at
- * registration time (mirrors `pluginsIntrospectionRoutes`'s `report`
+ * registration time (parallels `pluginsIntrospectionRoutes`'s `report`
  * injection) so the route can be tested against a temp NDJSON file instead
  * of the real `.barnacle/submissions.ndjson`.
  */

package/dist/api/schemas/telemetry.d.ts

@@ -35,7 +35,7 @@ declare const judgeAggregateSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type JudgeAggregate = z.infer<typeof judgeAggregateSchema>;
 /**
- * Top-level verdict file produced by the judge skill for one batch. Mirrors
+ * Top-level verdict file produced by the judge skill for one batch. Parallels
  * beacon/pila's verdict-JSON shape but in Barnacle's camelCase convention.
  */
 export declare const judgeVerdictSchema: z.ZodObject<{

package/dist/api/schemas/telemetry.js

@@ -38,7 +38,7 @@ const judgeAggregateSchema = v4_1.z.object({
     overallPass: v4_1.z.number().int(),
 });
 /**
- * Top-level verdict file produced by the judge skill for one batch. Mirrors
+ * Top-level verdict file produced by the judge skill for one batch. Parallels
  * beacon/pila's verdict-JSON shape but in Barnacle's camelCase convention.
  */
 exports.judgeVerdictSchema = v4_1.z.object({

package/dist/cache/response-cache.d.ts

@@ -24,7 +24,7 @@ export declare function cacheStats(): {
 };
 /**
  * Runs `producer` once per key even when multiple callers race on a
- * cache miss. The first caller kicks off the upstream call and all
+ * cache miss. The first caller kicks off the origin call and all
  * concurrent callers await the same promise. On resolve, the value is
  * written to the LRU cache so subsequent (non-racing) reads hit
  * normally.

package/dist/cache/response-cache.js

@@ -21,7 +21,7 @@ const cache = new lru_cache_1.LRUCache({
     ttl: config_1.config.cache.ttlMs,
 });
 /**
- * Tracks upstream calls that are currently resolving for a given key so
+ * Tracks origin calls that are currently resolving for a given key so
  * concurrent cache misses don't all fan out to the scraper. First miss
  * kicks off the work; subsequent misses await the same promise. Each
  * entry is removed after the promise settles (resolve or reject).
@@ -83,7 +83,7 @@ function cacheStats() {
 }
 /**
  * Runs `producer` once per key even when multiple callers race on a
- * cache miss. The first caller kicks off the upstream call and all
+ * cache miss. The first caller kicks off the origin call and all
  * concurrent callers await the same promise. On resolve, the value is
  * written to the LRU cache so subsequent (non-racing) reads hit
  * normally.

package/dist/config.d.ts

@@ -229,7 +229,7 @@ export interface AppConfig {
          */
         maxRetentionMs: number;
         /**
-         * Opt-in buffered S3 sink that mirrors local NDJSON telemetry so it
+         * Opt-in buffered S3 sink that replicates local NDJSON telemetry so it
          * survives ECS container restarts. Entirely inert when `bucket` is
          * undefined — the sink checks this before buffering or flushing.
          */
@@ -294,7 +294,7 @@ export interface AppConfig {
     selfheal: {
         /**
          * Maximum patch→replay→score iterations before giving up with
-         * BUDGET_EXHAUSTED. Mirrors the recon-heal default of 5.
+         * BUDGET_EXHAUSTED. Matches the recon-heal default of 5.
          */
         maxIterations: number;
         /**
@@ -304,12 +304,12 @@ export interface AppConfig {
         nReplays: number;
         /**
          * Minimum pass rate (0..1) to declare SUCCESS and stop iterating.
-         * Mirrors the pila llm-self-heal SKILL default of 0.9.
+         * Matches the pila llm-self-heal SKILL default of 0.9.
          */
         successThreshold: number;
         /**
          * Consecutive iterations whose pass-rate improvement is below
-         * `plateauDelta` that triggers a PLATEAUED verdict. Mirrors recon-heal.
+         * `plateauDelta` that triggers a PLATEAUED verdict. Matches recon-heal.
          */
         plateauWindow: number;
         /**

package/dist/lib/llm/judges/invalid-fields.d.ts

@@ -21,7 +21,7 @@ import type Anthropic from "@anthropic-ai/sdk";
 import type { z } from "zod/v4";
 import { type JudgeCaptureFn } from "../../../lib/llm/judge";
 import { INVALID_FIELDS_SCHEMA } from "../../../lib/llm/schemas";
-declare const INVALID_FIELDS_SYSTEM_PROMPT = "You are a strict invalid-field detector for browser forms. Given a body-HTML excerpt and (optionally) site-specific class-name prefixes, identify form fields that are structurally in an invalid/error state.\n\nStrict criteria for present=true (mark a field):\n- The container has a class containing \"invalid\" (e.g. ng-invalid, mat-form-field-invalid, is-invalid, field-invalid, app-input-invalid, etc.), OR\n- The element has aria-invalid=\"true\", OR\n- The element has data-invalid (truthy), OR\n- The container is structurally adjacent to an error-message container (class containing \"error\", \"validation\", \"feedback\", \"required\", \"help-block-error\", etc.), OR\n- The element is structurally adjacent to a visible error-text span/div that explains why it's invalid.\n\nDo NOT mark a field when:\n- Only visual styling indicates error (red border via CSS, no semantic marker).\n- The container is in a pristine/untouched state (e.g. ng-pristine ng-untouched alongside ng-invalid means the user hasn't interacted yet \u2014 that's a \"may become invalid\" state, not currently invalid).\n- The element is a hidden input or non-interactive ancestor.\n- The container is invalid ONLY because a descendant is invalid (parent-bubbled invalidity). Angular bubbles ng-invalid up to wrapping forms / lists / question containers; Bootstrap mirrors this on form-group; React Hook Form propagates aria-invalid through fieldsets. When you see <ol class=\"ng-invalid\"> with <li class=\"ng-valid\"> children where ONE deeper descendant is actually invalid, report ONLY the deepest leaf that carries the failure. The leaf is the smallest container with the invalid marker AND no further invalid descendants. Reporting bubbled parents alongside the real leaf creates false positives (the parent's children look like they're invalid when they are not).\n\nWhen the supplied knownErrorClassPrefixes list is non-empty, also treat class names starting with any of those prefixes followed by \"-invalid\" or \"-error\" as structural markers (site-specific convention).\n\nReturn up to 50 fields. Top-level present=true means at least one field is currently invalid. present=false means no structural invalid markers found anywhere in the excerpt.\n\nEach field entry:\n- containerXpath: a best-effort xpath identifying the container (tag + nth-of-type)\n- label: the visible label text near the field, or null if not discoverable\n- markerKind: which marker type triggered (\"class\", \"aria\", \"data\", \"error-container\", \"other\")\n- framework: which UI library this looks like (\"angular\", \"react\", \"vue\", \"mantine\", \"chakra\", \"bootstrap\", \"other\"). Look at framework-conventional class signatures to decide.";
+declare const INVALID_FIELDS_SYSTEM_PROMPT = "You are a strict invalid-field detector for browser forms. Given a body-HTML excerpt and (optionally) site-specific class-name prefixes, identify form fields that are structurally in an invalid/error state.\n\nStrict criteria for present=true (mark a field):\n- The container has a class containing \"invalid\" (e.g. ng-invalid, mat-form-field-invalid, is-invalid, field-invalid, app-input-invalid, etc.), OR\n- The element has aria-invalid=\"true\", OR\n- The element has data-invalid (truthy), OR\n- The container is structurally adjacent to an error-message container (class containing \"error\", \"validation\", \"feedback\", \"required\", \"help-block-error\", etc.), OR\n- The element is structurally adjacent to a visible error-text span/div that explains why it's invalid.\n\nDo NOT mark a field when:\n- Only visual styling indicates error (red border via CSS, no semantic marker).\n- The container is in a pristine/untouched state (e.g. ng-pristine ng-untouched alongside ng-invalid means the user hasn't interacted yet \u2014 that's a \"may become invalid\" state, not currently invalid).\n- The element is a hidden input or non-interactive ancestor.\n- The container is invalid ONLY because a descendant is invalid (parent-bubbled invalidity). Angular bubbles ng-invalid up to wrapping forms / lists / question containers; Bootstrap parallels this on form-group; React Hook Form propagates aria-invalid through fieldsets. When you see <ol class=\"ng-invalid\"> with <li class=\"ng-valid\"> children where ONE deeper descendant is actually invalid, report ONLY the deepest leaf that carries the failure. The leaf is the smallest container with the invalid marker AND no further invalid descendants. Reporting bubbled parents alongside the real leaf creates false positives (the parent's children look like they're invalid when they are not).\n\nWhen the supplied knownErrorClassPrefixes list is non-empty, also treat class names starting with any of those prefixes followed by \"-invalid\" or \"-error\" as structural markers (site-specific convention).\n\nReturn up to 50 fields. Top-level present=true means at least one field is currently invalid. present=false means no structural invalid markers found anywhere in the excerpt.\n\nEach field entry:\n- containerXpath: a best-effort xpath identifying the container (tag + nth-of-type)\n- label: the visible label text near the field, or null if not discoverable\n- markerKind: which marker type triggered (\"class\", \"aria\", \"data\", \"error-container\", \"other\")\n- framework: which UI library this looks like (\"angular\", \"react\", \"vue\", \"mantine\", \"chakra\", \"bootstrap\", \"other\"). Look at framework-conventional class signatures to decide.";
 export interface JudgeInvalidFieldsInput {
     /** Body HTML excerpt to scan (typically the page DOM, truncated to ~8KB). */
     bodyHtmlExcerpt: string;

package/dist/lib/llm/judges/invalid-fields.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"invalid-fields.d.ts","sourceRoot":"","sources":["../../../../src/lib/llm/judges/invalid-fields.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAG1D,QAAA,MAAM,4BAA4B,uqFAuB+I,CAAC;AAElL,MAAM,WAAW,uBAAuB;IACtC,6EAA6E;IAC7E,eAAe,EAAE,MAAM,CAAC;IACxB,gGAAgG;IAChG,uBAAuB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAWD;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAAC,MAAM,EAAE;IACtD,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,uBAAuB,CAAC;IAC/B,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,GAAG,IAAI,CAAC,CAYxD;AAED,OAAO,EAAE,4BAA4B,EAAE,CAAC"}
+{"version":3,"file":"invalid-fields.d.ts","sourceRoot":"","sources":["../../../../src/lib/llm/judges/invalid-fields.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAG1D,QAAA,MAAM,4BAA4B,yqFAuB+I,CAAC;AAElL,MAAM,WAAW,uBAAuB;IACtC,6EAA6E;IAC7E,eAAe,EAAE,MAAM,CAAC;IACxB,gGAAgG;IAChG,uBAAuB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAWD;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAAC,MAAM,EAAE;IACtD,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,uBAAuB,CAAC;IAC/B,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,GAAG,IAAI,CAAC,CAYxD;AAED,OAAO,EAAE,4BAA4B,EAAE,CAAC"}

package/dist/lib/llm/judges/invalid-fields.js

@@ -37,7 +37,7 @@ Do NOT mark a field when:
 - Only visual styling indicates error (red border via CSS, no semantic marker).
 - The container is in a pristine/untouched state (e.g. ng-pristine ng-untouched alongside ng-invalid means the user hasn't interacted yet — that's a "may become invalid" state, not currently invalid).
 - The element is a hidden input or non-interactive ancestor.
-- The container is invalid ONLY because a descendant is invalid (parent-bubbled invalidity). Angular bubbles ng-invalid up to wrapping forms / lists / question containers; Bootstrap mirrors this on form-group; React Hook Form propagates aria-invalid through fieldsets. When you see <ol class="ng-invalid"> with <li class="ng-valid"> children where ONE deeper descendant is actually invalid, report ONLY the deepest leaf that carries the failure. The leaf is the smallest container with the invalid marker AND no further invalid descendants. Reporting bubbled parents alongside the real leaf creates false positives (the parent's children look like they're invalid when they are not).
+- The container is invalid ONLY because a descendant is invalid (parent-bubbled invalidity). Angular bubbles ng-invalid up to wrapping forms / lists / question containers; Bootstrap parallels this on form-group; React Hook Form propagates aria-invalid through fieldsets. When you see <ol class="ng-invalid"> with <li class="ng-valid"> children where ONE deeper descendant is actually invalid, report ONLY the deepest leaf that carries the failure. The leaf is the smallest container with the invalid marker AND no further invalid descendants. Reporting bubbled parents alongside the real leaf creates false positives (the parent's children look like they're invalid when they are not).
 
 When the supplied knownErrorClassPrefixes list is non-empty, also treat class names starting with any of those prefixes followed by "-invalid" or "-error" as structural markers (site-specific convention).
 

package/dist/lib/llm/judges/verify-submit.js

@@ -41,7 +41,7 @@ When verified=true, populate the three signal fields with what you found (any ca
 When verified=false, write a one-sentence reason citing what you'd need to see to be convinced.`;
 exports.SUBMIT_VERIFY_SYSTEM_PROMPT = SUBMIT_VERIFY_SYSTEM_PROMPT;
 /**
- * Render the evidence into a user prompt for Haiku. The structure mirrors
+ * Render the evidence into a user prompt for Haiku. The structure parallels
  * the empirical-replay prototype that proved this works on production cases.
  */
 function buildVerifySubmitPrompt(input) {

package/dist/lib/logging.d.ts

@@ -21,7 +21,7 @@ export declare function extendLogger(logger: pino.Logger): Logger;
 /**
  * Returns a pino logger for one-shot CLI scripts. Uses pino-pretty in
  * development (where the devDependency is installed) and falls back to raw
- * JSON elsewhere, mirroring `getLogger`'s gating — `pino-pretty` is pruned
+ * JSON elsewhere, paralleling `getLogger`'s gating — `pino-pretty` is pruned
  * from production images, so an unconditional transport crashes on module
  * load in prod (see the pino-pretty prod-crash incident).
  */

package/dist/lib/logging.js

@@ -166,7 +166,7 @@ function extendLogger(logger) {
 /**
  * Returns a pino logger for one-shot CLI scripts. Uses pino-pretty in
  * development (where the devDependency is installed) and falls back to raw
- * JSON elsewhere, mirroring `getLogger`'s gating — `pino-pretty` is pruned
+ * JSON elsewhere, paralleling `getLogger`'s gating — `pino-pretty` is pruned
  * from production images, so an unconditional transport crashes on module
  * load in prod (see the pino-pretty prod-crash incident).
  */

package/dist/lib/telemetry/beacon-capture.d.ts

@@ -9,7 +9,7 @@
  * `requestId` (see `reconciliation-record.ts`, `submission-reader.ts`).
  *
  * Writes to the SAME sink as submit lines (`appendSubmissionSinkLine`,
- * feat-003), which is what lets the S3 mirror carry beacon lines for free
+ * feat-003), which is what lets the S3 replica carry beacon lines for free
  * with zero `s3-sink.ts` changes.
  *
  * `createBeaconOutcomeRecorder` builds on top of `captureBeaconEvent` to

package/dist/lib/telemetry/beacon-capture.js

@@ -10,7 +10,7 @@
  * `requestId` (see `reconciliation-record.ts`, `submission-reader.ts`).
  *
  * Writes to the SAME sink as submit lines (`appendSubmissionSinkLine`,
- * feat-003), which is what lets the S3 mirror carry beacon lines for free
+ * feat-003), which is what lets the S3 replica carry beacon lines for free
  * with zero `s3-sink.ts` changes.
  *
  * `createBeaconOutcomeRecorder` builds on top of `captureBeaconEvent` to

package/dist/lib/telemetry/call-capture.d.ts

@@ -6,7 +6,7 @@
 import { z } from "zod/v4";
 /**
  * Categorical failure reason for an LLM call. Surfaces post-mortem without
- * regex-scanning `errorMessage`. Discriminated upstream by the caller.
+ * regex-scanning `errorMessage`. Discriminated earlier by the caller.
  */
 export declare const llmCallFailureKindSchema: z.ZodEnum<{
     "anthropic-billing": "anthropic-billing";

package/dist/lib/telemetry/call-capture.js

@@ -18,7 +18,7 @@ const s3_sink_1 = require("../../lib/telemetry/s3-sink");
 const logger = (0, logging_1.getLogger)({ name: "telemetry/call-capture" });
 /**
  * Categorical failure reason for an LLM call. Surfaces post-mortem without
- * regex-scanning `errorMessage`. Discriminated upstream by the caller.
+ * regex-scanning `errorMessage`. Discriminated earlier by the caller.
  */
 exports.llmCallFailureKindSchema = v4_1.z.enum([
     "anthropic-billing",

package/dist/lib/telemetry/reconciliation-source.d.ts

@@ -1,6 +1,6 @@
 /**
  * Durable read path for reconciliation rows: unions the container-local
- * submissions sink with the S3-mirrored objects (feat-003's
+ * submissions sink with the S3-replicated objects (feat-003's
  * `listSubmissionsS3Objects` + `fetchSubmissionsS3Records`) before folding,
  * so a submit line written by one ECS task and its beacon line written by
  * another both land in the same row instead of two ephemeral, incomplete
@@ -9,11 +9,11 @@
  * beacon detail a cross-store fold still needs (see
  * `submission-reader.ts`'s `foldReconciliationRecords`).
  *
- * The local sink and its S3 mirror both receive the exact same line for
+ * The local sink and its S3 replica both receive the exact same line for
  * every event (`appendSubmissionSinkLine` writes to disk and buffers to S3
  * in the same call), so an overlap between the two stores is an exact JSON
  * duplicate, never a conflicting value — deduping on `kind:requestId:ts` is
- * lossless for that mirror case. But `ts` is formatISO second-precision, so
+ * lossless for that replica case. But `ts` is formatISO second-precision, so
  * two *distinct* beacon lines for the same `requestId` (e.g. dispatch's
  * automatic `skipped` line and a plugin's later self-recorded `fired` line)
  * can land in the same wall-clock second — the dedupe key for beacon
@@ -30,7 +30,7 @@ export interface ReadDurableReconciliationRowsOptions extends ListSubmissionsS3O
 }
 /**
  * Reads and folds the complete cross-container reconciliation history: the
- * local sink plus its S3 mirror, unioned and deduped before folding, so
+ * local sink plus its S3 replica, unioned and deduped before folding, so
  * `GET /v1/submissions` answers from durable storage instead of one ECS
  * task's ephemeral file. Falls back to local-only rows when no bucket is
  * configured or the S3 read fails.

package/dist/lib/telemetry/reconciliation-source.js

@@ -1,7 +1,7 @@
 "use strict";
 /**
  * Durable read path for reconciliation rows: unions the container-local
- * submissions sink with the S3-mirrored objects (feat-003's
+ * submissions sink with the S3-replicated objects (feat-003's
  * `listSubmissionsS3Objects` + `fetchSubmissionsS3Records`) before folding,
  * so a submit line written by one ECS task and its beacon line written by
  * another both land in the same row instead of two ephemeral, incomplete
@@ -10,11 +10,11 @@
  * beacon detail a cross-store fold still needs (see
  * `submission-reader.ts`'s `foldReconciliationRecords`).
  *
- * The local sink and its S3 mirror both receive the exact same line for
+ * The local sink and its S3 replica both receive the exact same line for
  * every event (`appendSubmissionSinkLine` writes to disk and buffers to S3
  * in the same call), so an overlap between the two stores is an exact JSON
  * duplicate, never a conflicting value — deduping on `kind:requestId:ts` is
- * lossless for that mirror case. But `ts` is formatISO second-precision, so
+ * lossless for that replica case. But `ts` is formatISO second-precision, so
  * two *distinct* beacon lines for the same `requestId` (e.g. dispatch's
  * automatic `skipped` line and a plugin's later self-recorded `fired` line)
  * can land in the same wall-clock second — the dedupe key for beacon
@@ -46,7 +46,7 @@ async function readLocalRecords(sinkPath) {
     return (0, submission_reader_1.parseReconciliationLines)(content);
 }
 /**
- * Lists and fetches the S3-mirrored records for the window. A rejection
+ * Lists and fetches the S3-replicated records for the window. A rejection
  * anywhere in the S3 path (listing or fetch) is logged and swallowed rather
  * than propagated, so an S3 outage degrades the answer to local-only instead
  * of failing the whole read.
@@ -91,7 +91,7 @@ function mergeRecords(localRecords, s3Records) {
 }
 /**
  * Reads and folds the complete cross-container reconciliation history: the
- * local sink plus its S3 mirror, unioned and deduped before folding, so
+ * local sink plus its S3 replica, unioned and deduped before folding, so
  * `GET /v1/submissions` answers from durable storage instead of one ECS
  * task's ephemeral file. Falls back to local-only rows when no bucket is
  * configured or the S3 read fails.

package/dist/lib/telemetry/run-telemetry.d.ts

@@ -1,7 +1,7 @@
 /**
  * Run-scoped, mutable telemetry accumulator that a plugin can write
  * discovered fields into at any point during execute()/executeHttp() —
- * mirrors `MetricsCollector` (src/lib/dispatch-metrics.ts) as a per-request
+ * parallels `MetricsCollector` (src/lib/dispatch-metrics.ts) as a per-request
  * instance meant to be threaded through the plugin context, but for
  * run-discovered data (join keys, session info) rather than step timings.
  * Funnels everything a plugin discovers mid-run into the same opaque

package/dist/lib/telemetry/run-telemetry.js

@@ -2,7 +2,7 @@
 /**
  * Run-scoped, mutable telemetry accumulator that a plugin can write
  * discovered fields into at any point during execute()/executeHttp() —
- * mirrors `MetricsCollector` (src/lib/dispatch-metrics.ts) as a per-request
+ * parallels `MetricsCollector` (src/lib/dispatch-metrics.ts) as a per-request
  * instance meant to be threaded through the plugin context, but for
  * run-discovered data (join keys, session info) rather than step timings.
  * Funnels everything a plugin discovers mid-run into the same opaque

package/dist/lib/telemetry/s3-sink.d.ts

@@ -1,5 +1,5 @@
 /**
- * Buffered S3 sink that mirrors local NDJSON telemetry so it survives ECS
+ * Buffered S3 sink that replicates local NDJSON telemetry so it survives ECS
  * container restarts. Opt-in: entirely inert (no S3Client construction, no
  * network calls) when `config.telemetry.s3.bucket` is unset. Buffers lines
  * in module-level arrays and flushes each non-empty buffer to a single S3

package/dist/lib/telemetry/s3-sink.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * Buffered S3 sink that mirrors local NDJSON telemetry so it survives ECS
+ * Buffered S3 sink that replicates local NDJSON telemetry so it survives ECS
  * container restarts. Opt-in: entirely inert (no S3Client construction, no
  * network calls) when `config.telemetry.s3.bucket` is unset. Buffers lines
  * in module-level arrays and flushes each non-empty buffer to a single S3

package/dist/lib/telemetry/submissions-s3-objects.d.ts

@@ -4,7 +4,7 @@
  * requested `from`/`to` window, so the fetch stage (feat-003) never has to
  * scan the whole telemetry bucket. Entirely inert (no `S3Client`
  * construction, no network calls) when `config.telemetry.s3.bucket` is
- * unset — mirrors `s3-sink.ts`'s inertness contract.
+ * unset — parallels `s3-sink.ts`'s inertness contract.
  */
 /** Filter window for `listSubmissionsS3Objects`. Both bounds are ISO datetime strings. */
 export interface ListSubmissionsS3ObjectsOptions {

package/dist/lib/telemetry/submissions-s3-objects.js

@@ -5,7 +5,7 @@
  * requested `from`/`to` window, so the fetch stage (feat-003) never has to
  * scan the whole telemetry bucket. Entirely inert (no `S3Client`
  * construction, no network calls) when `config.telemetry.s3.bucket` is
- * unset — mirrors `s3-sink.ts`'s inertness contract.
+ * unset — parallels `s3-sink.ts`'s inertness contract.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.listSubmissionsS3Objects = listSubmissionsS3Objects;

package/dist/lib/telemetry/submissions-s3-reader.d.ts

@@ -7,7 +7,7 @@
  * containers are ephemeral and per-task) becomes readable. Folding beacon
  * lines onto submit records and merging with the local sink live elsewhere.
  *
- * Mirrors `s3-sink.ts`'s inertness contract: no `S3Client` construction, no
+ * Parallels `s3-sink.ts`'s inertness contract: no `S3Client` construction, no
  * network calls, when `config.telemetry.s3.bucket` is unset.
  */
 import type { ReconciliationRecord } from "../../lib/telemetry/reconciliation-record";

package/dist/lib/telemetry/submissions-s3-reader.js

@@ -8,7 +8,7 @@
  * containers are ephemeral and per-task) becomes readable. Folding beacon
  * lines onto submit records and merging with the local sink live elsewhere.
  *
- * Mirrors `s3-sink.ts`'s inertness contract: no `S3Client` construction, no
+ * Parallels `s3-sink.ts`'s inertness contract: no `S3Client` construction, no
  * network calls, when `config.telemetry.s3.bucket` is unset.
  */
 var __importDefault = (this && this.__importDefault) || function (mod) {

package/dist/plugins/config-plugin.js

@@ -135,7 +135,7 @@ function buildRephraseModelForContext(appConfig) {
     return provider.languageModel(modelId);
 }
 /**
- * Builds the upload fixture the browser flow uploads, mirroring the rule the
+ * Builds the upload fixture the browser flow uploads, matching the rule the
  * generator's `emitBrowserFlowTs` applies: only when a step uploads AND the
  * manifest declares itself multipart do the `Resume*` payload fields exist.
  */
@@ -154,7 +154,7 @@ function buildUploadFixture(payload, hasUploadStep, multipart) {
  * for an import it does not use, and a broken `httpModule` disables the plugin
  * via the loader's normal failure path rather than crashing the factory.
  *
- * Resolution mirrors the loader's `resolvePluginSpecifier`: a `.`/`/` specifier
+ * Resolution parallels the loader's `resolvePluginSpecifier`: a `.`/`/` specifier
  * is a filesystem path resolved against `baseDir` (so a relative `httpModule`
  * resolves against the operator's `BARNACLE_PLUGINS_DIR`, not this module's
  * location under `dist/`); anything else is a bare package name left for Node's

package/dist/recon/load-form-schema.d.ts

@@ -13,7 +13,7 @@ export declare const FORM_SCHEMA_NONE = "none";
  *
  * Resolution reuses {@link resolvePluginSpecifier}, so `--form-schema` accepts the
  * same specifier forms as `BARNACLE_PLUGINS` and `--vocabulary`. Export resolution
- * mirrors the plugin loader's `m.formSchema ?? m.default ?? m`. The
+ * matches the plugin loader's `m.formSchema ?? m.default ?? m`. The
  * {@link FORM_SCHEMA_NONE} sentinel returns `null` (not an empty struct — see the
  * form-schema module for why), the shape for "this site has no ATS form data."
  *

package/dist/recon/load-form-schema.js

@@ -43,7 +43,7 @@ const formSchemaSchema = v4_1.z.object({
  *
  * Resolution reuses {@link resolvePluginSpecifier}, so `--form-schema` accepts the
  * same specifier forms as `BARNACLE_PLUGINS` and `--vocabulary`. Export resolution
- * mirrors the plugin loader's `m.formSchema ?? m.default ?? m`. The
+ * matches the plugin loader's `m.formSchema ?? m.default ?? m`. The
  * {@link FORM_SCHEMA_NONE} sentinel returns `null` (not an empty struct — see the
  * form-schema module for why), the shape for "this site has no ATS form data."
  *

package/dist/recon/load-vocabulary.d.ts

@@ -13,7 +13,7 @@ export declare const VOCABULARY_NONE = "none";
  *
  * Resolution reuses {@link resolvePluginSpecifier}, so `--vocabulary` accepts the
  * same specifier forms as `BARNACLE_PLUGINS` (relative path or package name) and
- * consumers learn one rule instead of two. Export resolution mirrors the plugin
+ * consumers learn one rule instead of two. Export resolution matches the plugin
  * loader's `m.vocabulary ?? m.default ?? m`, since a named-only export failing
  * silently is a known foot-gun in this codebase.
  *

package/dist/recon/load-vocabulary.js

@@ -27,7 +27,7 @@ exports.VOCABULARY_NONE = "none";
 const regexSchema = v4_1.z.custom((v) => v instanceof RegExp && !v.global && !v.sticky, {
     message: "expected a RegExp literal without the g or y flag (they make .test() stateful)",
 });
-/** Mirrors the emitter's identifier rule: a field name is spliced into source as
+/** Matches the emitter's identifier rule: a field name is spliced into source as
  * `payload.<name>` / `{{ .request.<name> }}`, so anything else emits a broken
  * plugin that still generates and still typechecks. */
 const payloadFieldNameSchema = v4_1.z
@@ -48,7 +48,7 @@ const vocabularySchema = v4_1.z.object({
  *
  * Resolution reuses {@link resolvePluginSpecifier}, so `--vocabulary` accepts the
  * same specifier forms as `BARNACLE_PLUGINS` (relative path or package name) and
- * consumers learn one rule instead of two. Export resolution mirrors the plugin
+ * consumers learn one rule instead of two. Export resolution matches the plugin
  * loader's `m.vocabulary ?? m.default ?? m`, since a named-only export failing
  * silently is a known foot-gun in this codebase.
  *

package/dist/scraper/deep-locator-actuate.d.ts

@@ -1,5 +1,5 @@
 /**
- * Fill/select actuation seam over `deepLocator`, mirroring
+ * Fill/select actuation seam over `deepLocator`, paralleling
  * `clickDeepLocatorCandidate`'s contract (`deep-locator-candidates.ts`) for
  * the two other primitives a cross-origin OOPIF form's text/select steps
  * need. Stagehand `act`/`observe` are measured blind inside that OOPIF, and

package/dist/scraper/deep-locator-actuate.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * Fill/select actuation seam over `deepLocator`, mirroring
+ * Fill/select actuation seam over `deepLocator`, paralleling
  * `clickDeepLocatorCandidate`'s contract (`deep-locator-candidates.ts`) for
  * the two other primitives a cross-origin OOPIF form's text/select steps
  * need. Stagehand `act`/`observe` are measured blind inside that OOPIF, and
@@ -80,7 +80,7 @@ async function writeAndVerify(write, readBack, expected) {
  * throws) when `frameSelector` is unset, the probe rejects (e.g. a fake
  * `Page` in a legacy-path test lacking `evaluate`/`frames`), or nothing
  * attaches within the probe's budget — each of those means "no frame seam
- * available", and the caller degrades to the legacy delegate path. Mirrors
+ * available", and the caller degrades to the legacy delegate path. Parallels
  * `deep-locator-candidates.ts`'s `resolveScanFrameTarget` exactly; duplicated
  * (not imported) so this module stays a leaf that never depends on
  * `deep-locator-candidates.ts`.
@@ -142,7 +142,7 @@ async function confirmBatchedWriteStuck(frameTarget, expression, expected) {
  * available, the evaluate call rejects, or the resolved payload doesn't
  * conform to {@link FrameCandidateWriteResult} — every one of those degrades
  * the caller to the legacy delegate path instead of losing the write,
- * mirroring `clickCandidateBatched`'s degrade contract
+ * paralleling `clickCandidateBatched`'s degrade contract
  * (`deep-locator-candidates.ts`).
  */
 async function actuateCandidateBatched(page, frameSelector, hopSelector, index, timeoutOptions, expression, actionLabel) {