raven-mcp 1.8.0 → 1.9.0

package/README.md

@@ -67,6 +67,7 @@ cd raven-mcp && npm install && npm run build
 | `audit_layout` | Evaluate visual rhythm, alignment, and optical balance |
 | `audit_responsive_visibility` | Render a URL at multiple breakpoints and flag content elements that are visible on desktop but hidden on mobile (display:none/opacity:0/zero-size) — categorises each as likely-oversight (content vanishing on mobile) vs intentional (decorative) |
 | `audit_contrast` | Compute WCAG contrast ratios for every text element on a rendered page and report AA (4.5:1 / 3:1 large) and AAA pass-fail per element, with delta-to-pass for failures |
+| `audit_url` | Render a live URL at each viewport×theme, scroll-settle, fire interactions, capture real pixels + DOM, then run the page/contrast/responsive/blank-media checks **plus** sliced-image edge-symmetry and hover-state white-wash detection over the captures — every finding tagged confirmed/likely-artifact/inconclusive, ranked by severity |
 | `audit_swiftui` | Audit SwiftUI source against Apple HIG — Dynamic Type, semantic colors, 44pt targets, 4/8pt spacing, AccentColor |
 | `audit_ios_screen` | Score a rendered iOS screen from an accessibility/view-hierarchy snapshot — 44pt targets + contrast + rhythm, in points |
 | `audit_ios_privacy` | Audit Info.plist (or Expo app.json) /PRIVACY.md/entitlements/source — usage-string honesty, ATS, Android permissions, bundled secrets, undisclosed default data-egress |

package/dist/asset-integrity.d.ts

@@ -11,3 +11,33 @@ export type AssetIntegrityOptions = {
     varianceThreshold?: number;
 };
 export declare function auditAssetIntegrity(imagePaths: string[], opts?: AssetIntegrityOptions): Promise<AssetIntegrityResult[]>;
+export type ImageEdgeSample = {
+    selector: string;
+    width: number;
+    height: number;
+    edges: {
+        top: number;
+        bottom: number;
+        left: number;
+        right: number;
+    };
+    tainted: boolean;
+};
+export type ImageEdgeVerdict = {
+    selector: string;
+    verdict: "clean" | "likely-sliced" | "inconclusive";
+    cut_edge: "top" | "bottom" | "left" | "right" | null;
+    confidence: number;
+    edges: {
+        top: number;
+        bottom: number;
+        left: number;
+        right: number;
+    };
+    reason: string;
+};
+export type ImageEdgeOptions = {
+    highVarianceThreshold?: number;
+    uniformRatio?: number;
+};
+export declare function auditImageEdges(samples: ImageEdgeSample[], opts?: ImageEdgeOptions): ImageEdgeVerdict[];

package/dist/asset-integrity.js

@@ -101,4 +101,70 @@ function errorMessage(error) {
     }
     return String(error);
 }
+export function auditImageEdges(samples, opts = {}) {
+    const highVar = opts.highVarianceThreshold ?? 200;
+    const uniformRatio = opts.uniformRatio ?? 0.25;
+    return (samples || []).map(function (sample) {
+        const e = sample.edges;
+        if (sample.tainted) {
+            return {
+                selector: sample.selector,
+                verdict: "inconclusive",
+                cut_edge: null,
+                confidence: 0,
+                edges: e,
+                reason: "image pixels unreadable (cross-origin canvas taint) — could not sample edges"
+            };
+        }
+        // Opposite-edge pairs: an edge "looks cut" when it carries high-variance
+        // content while the edge facing it is near-uniform.
+        const pairs = [
+            { edge: "bottom", v: e.bottom, opposite: e.top },
+            { edge: "top", v: e.top, opposite: e.bottom },
+            { edge: "right", v: e.right, opposite: e.left },
+            { edge: "left", v: e.left, opposite: e.right }
+        ];
+        let worst = null;
+        for (const p of pairs) {
+            const asymmetric = p.v > highVar && p.opposite < highVar * uniformRatio;
+            if (asymmetric && (worst === null || p.v > worst.v)) {
+                worst = p;
+            }
+        }
+        if (worst === null) {
+            return {
+                selector: sample.selector,
+                verdict: "clean",
+                cut_edge: null,
+                confidence: clamp(1 - maxEdge(e) / highVar, 0, 1),
+                edges: e,
+                reason: "all edges uniform — no content running into a frame edge"
+            };
+        }
+        // Confidence grows with how far the cut edge exceeds the threshold and how
+        // uniform the opposite edge is.
+        const overshoot = clamp(worst.v / (highVar * 4), 0, 1);
+        const oppositeUniformity = clamp(1 - worst.opposite / (highVar * uniformRatio), 0, 1);
+        const confidence = Math.max(0.5, (overshoot + oppositeUniformity) / 2);
+        return {
+            selector: sample.selector,
+            verdict: "likely-sliced",
+            cut_edge: worst.edge,
+            confidence: Math.round(confidence * 100) / 100,
+            edges: e,
+            reason: "high-variance content at the " +
+                worst.edge +
+                " edge (variance " +
+                Math.round(worst.v) +
+                ") with a uniform opposite edge (variance " +
+                Math.round(worst.opposite) +
+                ") — content appears cut off at the " +
+                worst.edge +
+                " frame edge"
+        };
+    });
+}
+function maxEdge(e) {
+    return Math.max(e.top, e.bottom, e.left, e.right);
+}
 //# sourceMappingURL=asset-integrity.js.map

package/dist/asset-integrity.js.map

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

package/dist/audit-url.d.ts

@@ -0,0 +1,74 @@
+/**
+ * audit-url.ts — Layer 0 render-and-capture transport.
+ *
+ * Renders a live URL at each viewport×theme, scroll-settles, fires interactions,
+ * captures real pixels + DOM, then runs the EXISTING checks (audit_page rule
+ * engine, contrast, responsive-visibility, video-blank, screenshot diff) plus
+ * pixel checks (image edge symmetry) over the captured output. Every finding is
+ * tagged confirmed | likely-artifact | inconclusive with its evidence, and
+ * ranked by severity.
+ *
+ * This tool does NOT reimplement the checks — it reuses:
+ *   · runPageChecks            (the audit_page rule engine, shared verbatim)
+ *   · verifyFindings           (the adversarial confirmed/likely-artifact tagger)
+ *   · captureResponsiveVisibility (desktop-visible / mobile-hidden divergence)
+ *   · auditContrastUrl         (per-element WCAG AA/AAA)
+ *   · capturePage video-blank detection
+ *   · auditImageEdges          (sliced/cropped image edge symmetry)
+ *   · diffScreenshots          (baseline vs post-interaction state diff)
+ */
+import type { Interaction, Theme } from "./capture.js";
+export type ViewportSpec = {
+    w: number;
+    h: number;
+    label?: string;
+};
+export type Verdict = "confirmed" | "likely-artifact" | "inconclusive";
+export type FindingSource = "page" | "contrast" | "responsive-visibility" | "video" | "asset-integrity" | "hover-state";
+export type AuditUrlFinding = {
+    source: FindingSource;
+    rule: string;
+    severity: "error" | "warning" | "info";
+    message: string;
+    fix: string;
+    selector?: string;
+    viewport: string;
+    theme: Theme;
+    verdict: Verdict;
+    evidence: string;
+};
+export type AuditUrlCapture = {
+    viewport: string;
+    theme: Theme;
+    scrolledToBottom: boolean;
+    screenshot_bytes: number;
+    screenshot?: string;
+};
+export type AuditUrlResult = {
+    tool: "audit_url";
+    url: string;
+    viewports: ViewportSpec[];
+    themes: Theme[];
+    findings: AuditUrlFinding[];
+    counts: {
+        total: number;
+        confirmed: number;
+        likely_artifact: number;
+        inconclusive: number;
+        errors: number;
+        warnings: number;
+    };
+    summary: string;
+    captures: AuditUrlCapture[];
+    warnings: string[];
+};
+export type AuditUrlOptions = {
+    viewports?: ViewportSpec[];
+    themes?: Theme[];
+    scroll_settle?: boolean;
+    interactions?: Interaction[];
+    containerMaxWidth?: number;
+    timeoutMs?: number;
+    includeScreenshots?: boolean;
+};
+export declare function auditUrl(url: string, opts?: AuditUrlOptions): Promise<AuditUrlResult>;

package/dist/audit-url.js

@@ -0,0 +1,327 @@
+/**
+ * audit-url.ts — Layer 0 render-and-capture transport.
+ *
+ * Renders a live URL at each viewport×theme, scroll-settles, fires interactions,
+ * captures real pixels + DOM, then runs the EXISTING checks (audit_page rule
+ * engine, contrast, responsive-visibility, video-blank, screenshot diff) plus
+ * pixel checks (image edge symmetry) over the captured output. Every finding is
+ * tagged confirmed | likely-artifact | inconclusive with its evidence, and
+ * ranked by severity.
+ *
+ * This tool does NOT reimplement the checks — it reuses:
+ *   · runPageChecks            (the audit_page rule engine, shared verbatim)
+ *   · verifyFindings           (the adversarial confirmed/likely-artifact tagger)
+ *   · captureResponsiveVisibility (desktop-visible / mobile-hidden divergence)
+ *   · auditContrastUrl         (per-element WCAG AA/AAA)
+ *   · capturePage video-blank detection
+ *   · auditImageEdges          (sliced/cropped image edge symmetry)
+ *   · diffScreenshots          (baseline vs post-interaction state diff)
+ */
+import { capturePage, verifyFindings, CaptureUnavailableError } from "./capture.js";
+import { runPageChecks } from "./page-checks.js";
+import { captureResponsiveVisibility } from "./responsive.js";
+import { auditContrastUrl } from "./contrast.js";
+import { auditImageEdges } from "./asset-integrity.js";
+import { diffScreenshots } from "./image-diff.js";
+const DEFAULT_VIEWPORTS = [
+    { w: 393, h: 852, label: "iphone" },
+    { w: 1440, h: 900, label: "desktop" },
+    { w: 2160, h: 1200, label: "wide" }
+];
+const DEFAULT_THEMES = ["light", "dark"];
+const SEVERITY_RANK = { error: 0, warning: 1, info: 2 };
+function viewportLabel(v) {
+    return (v.label ? v.label : "vp") + " " + v.w + "×" + v.h;
+}
+export async function auditUrl(url, opts = {}) {
+    const viewports = opts.viewports && opts.viewports.length > 0 ? opts.viewports : DEFAULT_VIEWPORTS;
+    const themes = opts.themes && opts.themes.length > 0 ? opts.themes : DEFAULT_THEMES;
+    const scrollSettle = opts.scroll_settle !== false; // default true
+    const interactions = Array.isArray(opts.interactions) ? opts.interactions : [];
+    const timeoutMs = typeof opts.timeoutMs === "number" ? opts.timeoutMs : 30000;
+    const includeScreenshots = opts.includeScreenshots === true;
+    const findings = [];
+    const captures = [];
+    const warnings = [];
+    // ── Responsive visibility (run ONCE across all viewport widths) ─────────────
+    try {
+        const widths = viewports.map((v) => v.w);
+        const rv = await captureResponsiveVisibility(url, widths, { timeoutMs });
+        const rvLabel = "responsive " + Math.min(...rv.breakpoints) + "→" + Math.max(...rv.breakpoints);
+        for (const row of rv.flagged) {
+            const oversight = row.category === "likely-oversight";
+            findings.push({
+                source: "responsive-visibility",
+                rule: "responsive/hidden-on-mobile",
+                severity: oversight ? "error" : "info",
+                message: (oversight ? "Content element" : "Decorative element") +
+                    " is visible on desktop but hidden on mobile" +
+                    (row.hidingClass ? " (" + row.hidingClass + ")" : ""),
+                fix: oversight
+                    ? "This is real content invisible on mobile — remove the responsive-hide or provide a mobile equivalent."
+                    : "Decorative element intentionally hidden on mobile — no action needed.",
+                selector: row.selector,
+                viewport: rvLabel,
+                theme: themes[0],
+                verdict: oversight ? "confirmed" : "likely-artifact",
+                evidence: "computed visibility across breakpoints: " +
+                    row.visibleAt.map((b) => b.breakpoint + "px=" + (b.visible ? "shown" : "hidden")).join(", ")
+            });
+        }
+    }
+    catch (error) {
+        if (error instanceof CaptureUnavailableError) {
+            return unavailableResult(url, viewports, themes);
+        }
+        warnings.push("responsive-visibility failed: " + errorMessage(error));
+    }
+    // ── Per viewport × theme ────────────────────────────────────────────────────
+    let firstPass = true;
+    for (const vp of viewports) {
+        for (const theme of themes) {
+            const vpLabel = viewportLabel(vp);
+            let cap;
+            try {
+                cap = await capturePage(url, {
+                    viewport: { w: vp.w, h: vp.h },
+                    theme,
+                    scroll_settle: scrollSettle,
+                    interactions,
+                    collectImageEdges: firstPass, // image slicing is source-level — sample once
+                    timeoutMs
+                });
+            }
+            catch (error) {
+                if (error instanceof CaptureUnavailableError) {
+                    return unavailableResult(url, viewports, themes);
+                }
+                warnings.push("capture failed (" + vpLabel + "/" + theme + "): " + errorMessage(error));
+                continue;
+            }
+            captures.push({
+                viewport: vpLabel,
+                theme,
+                scrolledToBottom: cap.scrolledToBottom,
+                screenshot_bytes: cap.screenshotBase64 ? cap.screenshotBase64.length : 0,
+                screenshot: includeScreenshots ? cap.screenshotBase64 : undefined
+            });
+            for (const w of cap.warnings)
+                warnings.push(vpLabel + "/" + theme + ": " + w);
+            // ── Page checks over the rendered DOM, then adversarially verify ─────────
+            const pageResult = runPageChecks(cap.renderedHtml, { containerMaxWidth: opts.containerMaxWidth });
+            const verifiable = pageResult.issues.map((iss, i) => ({
+                key: iss.rule + ":" + i,
+                kind: "issue",
+                rule: iss.rule,
+                message: iss.message
+            }));
+            let verdicts = [];
+            try {
+                verdicts = await verifyFindings({ html: cap.renderedHtml }, verifiable, { viewport: { w: vp.w, h: vp.h }, timeoutMs });
+            }
+            catch (error) {
+                warnings.push("page-check verification failed (" + vpLabel + "/" + theme + "): " + errorMessage(error));
+            }
+            pageResult.issues.forEach((iss, i) => {
+                const v = verdicts[i];
+                findings.push({
+                    source: "page",
+                    rule: iss.rule,
+                    severity: iss.severity,
+                    message: iss.message,
+                    fix: iss.fix,
+                    viewport: vpLabel,
+                    theme,
+                    verdict: normalizeVerdict(v ? v.verdict : undefined),
+                    evidence: v && v.evidence ? v.evidence : "rendered-DOM check (no independent re-check available)"
+                });
+            });
+            // ── Blank / empty media containers ───────────────────────────────────────
+            for (const va of cap.videoArtifacts) {
+                findings.push({
+                    source: "video",
+                    rule: "media/blank-container",
+                    severity: "warning",
+                    message: "Media element rendered blank after scroll + play attempt",
+                    fix: "If this is a real video, ensure a valid source loads (and preload allows it); if it is a lazy preload=none clip, this is expected.",
+                    selector: va.selector,
+                    viewport: vpLabel,
+                    theme,
+                    // preload=none that we actively played and still got nothing back is a
+                    // genuinely empty/broken container, not merely lazy — surface it.
+                    verdict: "confirmed",
+                    evidence: "video readyState stayed < 2 (HAVE_CURRENT_DATA) after scrollIntoView + play(); preload=\"" +
+                        va.preload +
+                        "\""
+                });
+            }
+            // ── Image edge symmetry (sliced/cropped) — first pass only ───────────────
+            if (firstPass && cap.imageEdges && cap.imageEdges.length > 0) {
+                const edgeVerdicts = auditImageEdges(cap.imageEdges);
+                for (const ev of edgeVerdicts) {
+                    if (ev.verdict === "clean")
+                        continue;
+                    findings.push({
+                        source: "asset-integrity",
+                        rule: "asset/sliced-edge",
+                        severity: ev.verdict === "likely-sliced" ? "warning" : "info",
+                        message: ev.verdict === "likely-sliced"
+                            ? "Image content appears cut off at the " + ev.cut_edge + " edge"
+                            : "Image edges could not be analysed",
+                        fix: ev.verdict === "likely-sliced"
+                            ? "Re-export the image so content does not run into the " + ev.cut_edge + " frame edge."
+                            : "Serve the image same-origin (or with CORS) so its pixels can be sampled.",
+                        selector: ev.selector,
+                        viewport: vpLabel,
+                        theme,
+                        verdict: ev.verdict === "likely-sliced" ? "confirmed" : "inconclusive",
+                        evidence: ev.reason
+                    });
+                }
+            }
+            // ── Hover/interaction state diff (white-wash etc.) ───────────────────────
+            if (interactions.length > 0) {
+                try {
+                    const baseline = await capturePage(url, {
+                        viewport: { w: vp.w, h: vp.h },
+                        theme,
+                        scroll_settle: scrollSettle,
+                        timeoutMs
+                    });
+                    const diff = await diffScreenshots(baseline.screenshotBase64, cap.screenshotBase64);
+                    const brightness = diff.dimensions.find((d) => d.dimension === "brightness");
+                    const before = brightness ? brightness.before : 0;
+                    const after = brightness ? brightness.after : 0;
+                    const wash = diff.changed_ratio > 0.3 && after - before > 0.2 && after > 0.7;
+                    if (wash) {
+                        findings.push({
+                            source: "hover-state",
+                            rule: "interaction/state-wash",
+                            severity: "warning",
+                            message: "Firing the interaction(s) washed a large region toward white — content may be obscured in this state",
+                            fix: "Check the interaction's resulting state (e.g. an overlay/filter at full opacity) — it should not white-out underlying content.",
+                            viewport: vpLabel,
+                            theme,
+                            verdict: "confirmed",
+                            evidence: Math.round(diff.changed_ratio * 100) +
+                                "% of pixels changed and mean brightness rose " +
+                                before.toFixed(2) +
+                                " → " +
+                                after.toFixed(2) +
+                                " after the interaction (near-white)"
+                        });
+                    }
+                }
+                catch (error) {
+                    warnings.push("hover-state diff failed (" + vpLabel + "/" + theme + "): " + errorMessage(error));
+                }
+            }
+            // ── Per-element WCAG contrast ────────────────────────────────────────────
+            try {
+                const contrast = await auditContrastUrl(url, { viewport: { w: vp.w, h: vp.h }, theme, timeoutMs });
+                for (const row of contrast.aa_failures) {
+                    findings.push({
+                        source: "contrast",
+                        rule: "contrast/aa",
+                        severity: "error",
+                        message: "Text fails WCAG AA contrast (" +
+                            row.ratio +
+                            ":1, needs " +
+                            row.required_aa +
+                            ":1)" +
+                            (row.text ? ': "' + row.text + '"' : ""),
+                        fix: "Increase contrast by " +
+                            row.delta_to_aa +
+                            " — darken the text or lighten the background until the ratio reaches " +
+                            row.required_aa +
+                            ":1.",
+                        selector: row.selector,
+                        viewport: vpLabel,
+                        theme,
+                        verdict: "confirmed",
+                        evidence: "computed ratio " +
+                            row.ratio +
+                            ":1 between " +
+                            row.foreground +
+                            " on " +
+                            row.background +
+                            " at " +
+                            row.fontPx +
+                            "px (required AA " +
+                            row.required_aa +
+                            ":1)"
+                    });
+                }
+            }
+            catch (error) {
+                if (error instanceof CaptureUnavailableError) {
+                    return unavailableResult(url, viewports, themes);
+                }
+                warnings.push("contrast audit failed (" + vpLabel + "/" + theme + "): " + errorMessage(error));
+            }
+            firstPass = false;
+        }
+    }
+    // ── Rank by severity, then group by source ──────────────────────────────────
+    findings.sort((a, b) => {
+        const sr = (SEVERITY_RANK[a.severity] ?? 9) - (SEVERITY_RANK[b.severity] ?? 9);
+        if (sr !== 0)
+            return sr;
+        return a.source.localeCompare(b.source);
+    });
+    const counts = {
+        total: findings.length,
+        confirmed: findings.filter((f) => f.verdict === "confirmed").length,
+        likely_artifact: findings.filter((f) => f.verdict === "likely-artifact").length,
+        inconclusive: findings.filter((f) => f.verdict === "inconclusive").length,
+        errors: findings.filter((f) => f.severity === "error").length,
+        warnings: findings.filter((f) => f.severity === "warning").length
+    };
+    const summary = findings.length +
+        " findings across " +
+        viewports.length +
+        " viewport(s) × " +
+        themes.length +
+        " theme(s) — " +
+        counts.confirmed +
+        " confirmed, " +
+        counts.likely_artifact +
+        " likely-artifact, " +
+        counts.inconclusive +
+        " inconclusive";
+    return {
+        tool: "audit_url",
+        url,
+        viewports,
+        themes,
+        findings,
+        counts,
+        summary,
+        captures,
+        warnings
+    };
+}
+function normalizeVerdict(v) {
+    if (v === "confirmed" || v === "likely-artifact" || v === "inconclusive")
+        return v;
+    return "inconclusive";
+}
+function unavailableResult(url, viewports, themes) {
+    return {
+        tool: "audit_url",
+        url,
+        viewports,
+        themes,
+        findings: [],
+        counts: { total: 0, confirmed: 0, likely_artifact: 0, inconclusive: 0, errors: 0, warnings: 0 },
+        summary: "audit_url needs headless chromium. Run: npx playwright install chromium",
+        captures: [],
+        warnings: ["Playwright chromium not available. Run: npx playwright install chromium"]
+    };
+}
+function errorMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    return String(error);
+}
+//# sourceMappingURL=audit-url.js.map

package/dist/audit-url.js.map

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

package/dist/capture.d.ts

@@ -1,3 +1,6 @@
+import type { ImageEdgeSample } from "./asset-integrity.js";
+export type { ImageEdgeSample } from "./asset-integrity.js";
+export type Theme = "light" | "dark";
 export declare class CaptureUnavailableError extends Error {
     constructor(message?: string);
 }
@@ -15,8 +18,10 @@ export type CaptureResult = {
         w: number;
         h: number;
     };
+    theme?: Theme;
     scrolledToBottom: boolean;
     videoArtifacts: VideoArtifact[];
+    imageEdges?: ImageEdgeSample[];
     warnings: string[];
 };
 export type Interaction = {
@@ -31,6 +36,8 @@ export type CaptureOptions = {
         w: number;
         h: number;
     };
+    theme?: Theme;
+    collectImageEdges?: boolean;
     timeoutMs?: number;
 };
 export declare function capturePage(url: string, opts?: CaptureOptions): Promise<CaptureResult>;