harnery 0.33.0 → 0.34.1

package/dist/lib/browser/client.js

@@ -378,6 +378,209 @@ export class Browser {
             return out;
         }, selector);
     }
+    /**
+     * Extract the page's visual atoms for content-aware tiling (tiling.ts):
+     * text line boxes (one per rendered line, so a cut between the lines of a
+     * paragraph is legal), replaced/intrinsically-visual elements, and small
+     * bordered boxes (cards, callouts — height-capped so section wrappers
+     * don't count). Coordinates are document-space CSS px.
+     */
+    async visualAtoms() {
+        return await this.currentPage.evaluate(() => {
+            const atoms = [];
+            const sy = window.scrollY;
+            const walker = document.createTreeWalker(document.body, NodeFilter.SHOW_TEXT);
+            let node = walker.nextNode();
+            while (node) {
+                if (node.textContent && node.textContent.trim().length > 0) {
+                    const range = document.createRange();
+                    range.selectNodeContents(node);
+                    for (const r of Array.from(range.getClientRects())) {
+                        if (r.height > 0 && r.width > 0) {
+                            atoms.push({ kind: "text-line", top: r.top + sy, bottom: r.bottom + sy });
+                        }
+                    }
+                }
+                node = walker.nextNode();
+            }
+            for (const el of Array.from(document.querySelectorAll("img, svg, canvas, video, input, button, select, textarea, hr"))) {
+                // Children of an inline <svg> are covered by the root svg's rect.
+                if (el instanceof SVGElement && el.ownerSVGElement)
+                    continue;
+                const r = el.getBoundingClientRect();
+                if (r.height > 0 && r.width > 0) {
+                    atoms.push({ kind: "replaced", top: r.top + sy, bottom: r.bottom + sy });
+                }
+            }
+            for (const el of Array.from(document.body.querySelectorAll("*"))) {
+                if (el instanceof SVGElement)
+                    continue;
+                const cs = getComputedStyle(el);
+                const hasEdge = (Number.parseFloat(cs.borderTopWidth) > 0 && cs.borderTopStyle !== "none") ||
+                    Number.parseFloat(cs.borderRadius) > 0;
+                if (!hasEdge)
+                    continue;
+                const r = el.getBoundingClientRect();
+                if (r.height > 0 && r.height <= 600 && r.width > 0) {
+                    atoms.push({ kind: "box", top: r.top + sy, bottom: r.bottom + sy });
+                }
+            }
+            return atoms;
+        });
+    }
+    /**
+     * Capture the page's QA signature for diff-aware classification
+     * (qa-plan.ts): a structural fingerprint per element (path, tag, canonical
+     * attributes, direct-text digest, nearest stable-ancestor anchor) plus
+     * applied-stylesheet digests. DOM equality alone never proves a change is
+     * text-only — a one-line edit to a linked stylesheet changes zero DOM bytes
+     * and every pixel — so external sheet text is fetched and digested too; an
+     * unreadable sheet records digest "unavailable" and the classifier widens.
+     */
+    async qaSignature() {
+        return await this.currentPage.evaluate(async () => {
+            const MAX_NODES = 20_000;
+            const fnv = (text) => {
+                let hash = 0x811c9dc5;
+                for (let i = 0; i < text.length; i++) {
+                    hash ^= text.charCodeAt(i);
+                    hash = Math.imul(hash, 0x01000193);
+                }
+                return `${(hash >>> 0).toString(16).padStart(8, "0")}-${text.length}`;
+            };
+            // Anchor uniqueness prepass: an id or data-qa-scope value that appears
+            // more than once is not a stable anchor.
+            const idCount = new Map();
+            for (const el of Array.from(document.querySelectorAll("[id]"))) {
+                idCount.set(el.id, (idCount.get(el.id) ?? 0) + 1);
+            }
+            const scopeCount = new Map();
+            for (const el of Array.from(document.querySelectorAll("[data-qa-scope]"))) {
+                const v = el.getAttribute("data-qa-scope") ?? "";
+                scopeCount.set(v, (scopeCount.get(v) ?? 0) + 1);
+            }
+            const anchorFor = (el) => {
+                if (el.id && idCount.get(el.id) === 1)
+                    return `#${CSS.escape(el.id)}`;
+                const scope = el.getAttribute("data-qa-scope");
+                if (scope && scopeCount.get(scope) === 1) {
+                    return `[data-qa-scope="${CSS.escape(scope)}"]`;
+                }
+                return null;
+            };
+            const SKIP = new Set(["SCRIPT", "NOSCRIPT", "TEMPLATE", "STYLE", "LINK", "META"]);
+            // Leaves whose subtree is fingerprinted as one opaque unit (mirrors the
+            // replaced-element treatment in visual atoms).
+            const LEAF = new Set(["SVG", "CANVAS", "VIDEO", "IFRAME", "OBJECT"]);
+            const nodes = [];
+            let truncated = false;
+            const visit = (el, path, anchor) => {
+                if (nodes.length >= MAX_NODES) {
+                    truncated = true;
+                    return;
+                }
+                const tag = el.tagName.toLowerCase();
+                const attrs = el
+                    .getAttributeNames()
+                    .sort()
+                    .map((name) => `${name}=${el.getAttribute(name) ?? ""}`)
+                    .join("\x1f");
+                const isLeaf = LEAF.has(el.tagName.toUpperCase());
+                let text;
+                let visual;
+                if (isLeaf) {
+                    if (el instanceof HTMLCanvasElement) {
+                        try {
+                            visual = fnv(el.toDataURL("image/png"));
+                        }
+                        catch {
+                            visual = "unavailable";
+                        }
+                    }
+                    else {
+                        visual = fnv(el.innerHTML);
+                    }
+                }
+                else {
+                    let direct = "";
+                    for (const child of Array.from(el.childNodes)) {
+                        if (child.nodeType === Node.TEXT_NODE)
+                            direct += child.textContent ?? "";
+                    }
+                    const normalized = direct.replace(/\s+/g, " ").trim();
+                    if (normalized)
+                        text = fnv(normalized);
+                }
+                nodes.push({
+                    path,
+                    tag,
+                    attrs,
+                    ...(text !== undefined ? { text } : {}),
+                    ...(visual !== undefined ? { visual } : {}),
+                    ...(anchor ? { anchor } : {}),
+                });
+                if (isLeaf)
+                    return;
+                const own = anchorFor(el);
+                const childAnchor = own ? { selector: own, path } : anchor;
+                let index = 0;
+                for (const child of Array.from(el.children)) {
+                    if (SKIP.has(child.tagName.toUpperCase()))
+                        continue;
+                    visit(child, `${path}>${child.tagName.toLowerCase()}:${index}`, childAnchor);
+                    index++;
+                }
+            };
+            if (document.body)
+                visit(document.body, "body", undefined);
+            const stylesheets = [];
+            let inlineIdx = 0;
+            for (const sheet of Array.from(document.styleSheets)) {
+                const href = sheet.href;
+                const key = href ?? `inline:${inlineIdx}`;
+                if (!href)
+                    inlineIdx++;
+                let digest = "unavailable";
+                try {
+                    digest = fnv(Array.from(sheet.cssRules)
+                        .map((rule) => rule.cssText)
+                        .join("\n"));
+                }
+                catch {
+                    // Cross-origin: cssRules throws. Fetch the sheet text instead; a
+                    // CORS-blocked fetch leaves the digest "unavailable" on purpose.
+                    if (href) {
+                        try {
+                            const res = await fetch(href);
+                            if (res.ok)
+                                digest = fnv(await res.text());
+                        }
+                        catch {
+                            /* stays unavailable */
+                        }
+                    }
+                }
+                stylesheets.push({ key, kind: href ? "external" : "inline", digest });
+            }
+            let adoptedIdx = 0;
+            for (const sheet of document.adoptedStyleSheets ?? []) {
+                try {
+                    stylesheets.push({
+                        key: `adopted:${adoptedIdx}`,
+                        kind: "inline",
+                        digest: fnv(Array.from(sheet.cssRules)
+                            .map((rule) => rule.cssText)
+                            .join("\n")),
+                    });
+                }
+                catch {
+                    stylesheets.push({ key: `adopted:${adoptedIdx}`, kind: "inline", digest: "unavailable" });
+                }
+                adoptedIdx++;
+            }
+            return { nodes, stylesheets, domHtml: document.documentElement.outerHTML, truncated };
+        });
+    }
     /**
      * Capture a full-page screenshot from an explicit capture viewport and
      * evaluate the caller's final evidence expression immediately before the

package/dist/lib/browser/critique.d.ts

@@ -1,9 +1,13 @@
+import { type VisualAtom } from "./tiling.js";
 export interface CritiqueTile {
     index: number;
     /** Section label or "band N", for locating a finding. */
     label: string;
     /** Document-space Y offset of the tile's top, so findings map to a place. */
     scrollY: number;
+    /** Document-space X offset (0 for full-width bands; element-relative for
+     * selector tiles). Optional for backward compatibility — treat absent as 0. */
+    x?: number;
     width: number;
     height: number;
     /** Base64 PNG of the tile (no data: prefix). */
@@ -25,17 +29,31 @@ export interface CritiqueResult {
     outcome: "pass" | "fail" | "skipped";
     /** Set when skipped or a provider call failed. */
     error?: string;
+    /** Host-reported provider provenance (route, attempts, fallbacks, usage). */
+    provider_meta?: Record<string, unknown>;
 }
 /**
  * The host-injected model call. Given one tile and the rubric, return the
  * findings for that tile. Throwing is caught and surfaced as an error finding
  * so one bad tile never sinks the run.
+ *
+ * Optional properties let the host shape execution without widening the call
+ * contract: `concurrency` caps how many tiles run at once (default 4 — tiles
+ * are independent, and the wall-clock win is roughly the cap factor), and
+ * `meta()` is read once after the run so route/usage provenance lands on the
+ * result envelope.
  */
-export type CritiqueProvider = (input: {
+export type CritiqueProvider = ((input: {
     url: string;
     rubric: string;
     tile: CritiqueTile;
-}) => Promise<CritiqueFinding[]>;
+}) => Promise<CritiqueFinding[]>) & {
+    concurrency?: number;
+    meta?: () => Record<string, unknown> | undefined;
+    /** Long-edge pixel budget of the routed model's vision input. The tiler
+     * clamps band height to it so tiles are never downscaled by the provider. */
+    tileBudgetPx?: number;
+};
 export declare const DEFAULT_CRITIQUE_RUBRIC: string;
 /**
  * Cut a page of height `pageHeight` into overlapping vertical bands. Pure math
@@ -57,6 +75,13 @@ export declare function bandRects(pageHeight: number, pageWidth: number, bandHei
  * resolution. Pass `elementRects` for semantic (per-element) tiling; otherwise
  * the page is banded from the actual image height. Rects are clamped to the
  * image so an off-by-one never throws.
+ *
+ * When `atoms` are supplied (see tiling.ts), band seams snap into content
+ * gaps instead of cutting at fixed offsets, and element rects taller than the
+ * band budget are banded internally rather than shipped as one over-tall tile
+ * the provider would downscale. Atom coordinates must be in the same pixel
+ * space as the screenshot (identical at deviceScaleFactor 1; scale them if
+ * the capture DPR differs).
  */
 export declare function tilesFromFullPage(fullPageBuffer: Buffer, opts: {
     elementRects?: Array<{
@@ -69,6 +94,7 @@ export declare function tilesFromFullPage(fullPageBuffer: Buffer, opts: {
     bandHeight?: number;
     overlap?: number;
     maxTiles: number;
+    atoms?: VisualAtom[];
 }): CritiqueTile[];
 /**
  * Validate + normalize a provider's raw output into CritiqueFindings. Tolerant

package/dist/lib/browser/critique.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"critique.d.ts","sourceRoot":"","sources":["../../../src/lib/browser/critique.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACrC,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,YAAY,CAAC;CACpB,KAAK,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;AAEjC,eAAO,MAAM,uBAAuB,QAaxB,CAAC;AAEb;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAY/E;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE;IACJ,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,GACA,YAAY,EAAE,CAqChB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE,CAyB/E;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,QAAQ,EAAE,gBAAgB,GAAG,SAAS,CAAC;CACxC,GAAG,OAAO,CAAC,cAAc,CAAC,CA6B1B"}
+{"version":3,"file":"critique.d.ts","sourceRoot":"","sources":["../../../src/lib/browser/critique.ts"],"names":[],"mappings":"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"}

package/dist/lib/browser/critique.js

@@ -17,6 +17,7 @@
 //      false pass. That keeps this portable — the tiling, prompt, and
 //      orchestration live here; the model call lives in the host.
 import { PNG } from "pngjs";
+import { bandOversizedRect, snappedBandRects } from "./tiling.js";
 export const DEFAULT_CRITIQUE_RUBRIC = [
     "You are reviewing one vertical slice of a rendered web page for visual defects.",
     "Report ONLY concrete, visible problems a careful designer would flag:",
@@ -26,6 +27,10 @@ export const DEFAULT_CRITIQUE_RUBRIC = [
     "- broken, distorted, or missing images",
     "- leaked template tokens, placeholder text, or obviously wrong values",
     "- anything that looks broken, unfinished, or accidental",
+    "The slice's own top and bottom edges cut through the page at arbitrary points:",
+    "content cropped by the slice boundary itself (a heading, row, or paragraph",
+    "entering or leaving the frame) is a tiling artifact, NOT a defect - never report it.",
+    "Only report clipping that happens at an element's own container edge inside the slice.",
     "Do NOT comment on content quality, wording, tone, or subjective taste.",
     "If the slice looks fine, return an empty list. Be precise and terse.",
     "Return JSON only: an array of objects",
@@ -59,12 +64,39 @@ export function bandRects(pageHeight, pageWidth, bandHeight, overlap) {
  * resolution. Pass `elementRects` for semantic (per-element) tiling; otherwise
  * the page is banded from the actual image height. Rects are clamped to the
  * image so an off-by-one never throws.
+ *
+ * When `atoms` are supplied (see tiling.ts), band seams snap into content
+ * gaps instead of cutting at fixed offsets, and element rects taller than the
+ * band budget are banded internally rather than shipped as one over-tall tile
+ * the provider would downscale. Atom coordinates must be in the same pixel
+ * space as the screenshot (identical at deviceScaleFactor 1; scale them if
+ * the capture DPR differs).
  */
 export function tilesFromFullPage(fullPageBuffer, opts) {
     const png = PNG.sync.read(fullPageBuffer);
-    const rects = opts.elementRects && opts.elementRects.length > 0
-        ? opts.elementRects.map((r, index) => ({ index, ...r }))
-        : bandRects(png.height, png.width, opts.bandHeight ?? 1400, opts.overlap ?? 120).map((b) => ({
+    const snapOpts = {
+        bandHeight: opts.bandHeight ?? 1400,
+        overlap: opts.overlap ?? 120,
+    };
+    let rects;
+    if (opts.elementRects && opts.elementRects.length > 0) {
+        const expanded = opts.atoms
+            ? opts.elementRects.flatMap((r) => bandOversizedRect(r, opts.atoms ?? [], snapOpts))
+            : opts.elementRects;
+        rects = expanded.map((r, index) => ({ index, ...r }));
+    }
+    else if (opts.atoms && opts.atoms.length > 0) {
+        rects = snappedBandRects(0, png.height, 0, png.width, opts.atoms, snapOpts).rects.map((b) => ({
+            index: b.index,
+            label: `band ${b.index + 1}`,
+            x: b.x,
+            y: b.y,
+            width: b.width,
+            height: b.height,
+        }));
+    }
+    else {
+        rects = bandRects(png.height, png.width, snapOpts.bandHeight, snapOpts.overlap).map((b) => ({
             index: b.index,
             label: `band ${b.index + 1}`,
             x: b.x,
@@ -72,6 +104,7 @@ export function tilesFromFullPage(fullPageBuffer, opts) {
             width: b.width,
             height: b.height,
         }));
+    }
     const tiles = [];
     for (const rect of rects.slice(0, opts.maxTiles)) {
         const sx = Math.max(0, Math.min(Math.round(rect.x), png.width - 1));
@@ -90,6 +123,7 @@ export function tilesFromFullPage(fullPageBuffer, opts) {
             index: rect.index,
             label: rect.label,
             scrollY: sy,
+            x: sx,
             width: w,
             height: h,
             pngBase64: PNG.sync.write(dst).toString("base64"),
@@ -147,21 +181,43 @@ export async function runCritique(args) {
             error: "no critiqueProvider injected by the host (see HarneryProgramContext.critiqueProvider)",
         };
     }
-    const findings = [];
-    for (const tile of tiles) {
-        try {
-            const tileFindings = await provider({ url, rubric, tile });
-            findings.push(...tileFindings.map((f) => ({ ...f, tile: tile.index })));
-        }
-        catch (err) {
-            findings.push({
-                tile: tile.index,
-                severity: "high",
-                category: "provider-error",
-                description: `critique provider failed on ${tile.label}: ${err instanceof Error ? err.message : String(err)}`,
-            });
+    // Tiles are judged independently, so run them concurrently (bounded) and
+    // reassemble findings in tile order so artifacts stay deterministic.
+    const concurrency = Math.max(1, Math.min(provider.concurrency ?? 4, tiles.length || 1));
+    const perTile = tiles.map(() => []);
+    let cursor = 0;
+    const worker = async () => {
+        while (true) {
+            const i = cursor++;
+            if (i >= tiles.length)
+                return;
+            const tile = tiles[i];
+            try {
+                const tileFindings = await provider({ url, rubric, tile });
+                perTile[i] = tileFindings.map((f) => ({ ...f, tile: tile.index }));
+            }
+            catch (err) {
+                perTile[i] = [
+                    {
+                        tile: tile.index,
+                        severity: "high",
+                        category: "provider-error",
+                        description: `critique provider failed on ${tile.label}: ${err instanceof Error ? err.message : String(err)}`,
+                    },
+                ];
+            }
         }
-    }
+    };
+    await Promise.all(Array.from({ length: concurrency }, () => worker()));
+    const findings = perTile.flat();
     const outcome = findings.some((f) => f.severity === "high") ? "fail" : "pass";
-    return { rule: "critique", tiles: tiles.length, provider: true, findings, outcome };
+    const meta = provider.meta?.();
+    return {
+        rule: "critique",
+        tiles: tiles.length,
+        provider: true,
+        findings,
+        outcome,
+        ...(meta ? { provider_meta: meta } : {}),
+    };
 }

package/dist/lib/browser/geometry.d.ts

@@ -21,7 +21,7 @@ export interface LayoutElementMeasurement {
 export interface LayoutExclusion {
     index: number;
     tag: string;
-    reason: "hidden" | "zero-area" | "out-of-flow" | "limit";
+    reason: "hidden" | "zero-area" | "out-of-flow" | "limit" | "visually-hidden" | "ellipsis-truncation";
 }
 export interface AlignChild extends LayoutElementMeasurement {
     mid: number;

package/dist/lib/browser/geometry.d.ts.map

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