@juangadm/pre-post 0.3.0 → 1.1.0

package/dist/landing.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Did a capture reach the page it asked for, or land somewhere else?
+ *
+ * Deployment protection, corporate SSO and IP allow-lists answer a request for
+ * a page with a sign-in screen, and they do it with HTTP 200 after a redirect —
+ * so the 401/403 guard in `browser.ts` never sees them. Screenshotting that and
+ * publishing the difference as a visual change is the worst failure this tool
+ * has: confident, and wrong. It happened on a real run, twice, before anyone
+ * noticed the "Post" screenshot was a login form.
+ *
+ * The test is deliberately narrow. A redirect on its own proves nothing — a
+ * site legitimately sends `example.xyz` to `example.org`, or apex to `www` —
+ * so only a redirect that ends somewhere *sign-in shaped* counts. Missing an
+ * exotic auth wall is recoverable; refusing to run against a site that redirects
+ * for ordinary reasons is not.
+ */
+/**
+ * The registrable-ish part of a host, so `www.example.com` and `example.com`
+ * read as one site. Two labels is a heuristic — it treats `a.co.uk` and
+ * `b.co.uk` as the same site — but it is only ever used to make the sign-in
+ * test *stricter*, never to reject anything on its own.
+ */
+export declare function siteOf(url: string): string;
+/** Did the navigation end up on a different site than the one requested? */
+export declare function leftTheSite(requested: string, final: string): boolean;
+/** Does this URL and title read as a sign-in page rather than a site's own page? */
+export declare function looksLikeSignIn(url: string, title?: string): boolean;
+export interface Landing {
+    /** Where the browser actually ended up. */
+    finalUrl: string;
+    /** True when the capture is of a sign-in wall, not of the requested page. */
+    blocked: boolean;
+    /** The wall is on another site entirely — usually an identity provider. */
+    offSite: boolean;
+}
+/**
+ * Judge where a capture landed.
+ *
+ * Blocked requires *both* that the browser moved and that where it moved to is
+ * sign-in shaped: asking for `/login` and getting `/login` is not a wall, and
+ * neither is a plain canonical-domain redirect.
+ */
+export declare function checkLanding(requested: string, finalUrl: string, title?: string): Landing;
+/**
+ * The one sentence a human needs. Names the fix, not the symptom.
+ */
+export declare function signInHint(url: string, vercel: boolean): string;
+//# sourceMappingURL=landing.d.ts.map

package/dist/landing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"landing.d.ts","sourceRoot":"","sources":["../src/landing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQ1C;AAED,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAIrE;AAMD,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAShE;AAED,MAAM,WAAW,OAAO;IACtB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,OAAO,EAAE,OAAO,CAAC;IACjB,2EAA2E;IAC3E,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAOrF;AAcD;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAO/D"}

package/dist/landing.js

@@ -0,0 +1,93 @@
+/**
+ * Did a capture reach the page it asked for, or land somewhere else?
+ *
+ * Deployment protection, corporate SSO and IP allow-lists answer a request for
+ * a page with a sign-in screen, and they do it with HTTP 200 after a redirect —
+ * so the 401/403 guard in `browser.ts` never sees them. Screenshotting that and
+ * publishing the difference as a visual change is the worst failure this tool
+ * has: confident, and wrong. It happened on a real run, twice, before anyone
+ * noticed the "Post" screenshot was a login form.
+ *
+ * The test is deliberately narrow. A redirect on its own proves nothing — a
+ * site legitimately sends `example.xyz` to `example.org`, or apex to `www` —
+ * so only a redirect that ends somewhere *sign-in shaped* counts. Missing an
+ * exotic auth wall is recoverable; refusing to run against a site that redirects
+ * for ordinary reasons is not.
+ */
+/**
+ * The registrable-ish part of a host, so `www.example.com` and `example.com`
+ * read as one site. Two labels is a heuristic — it treats `a.co.uk` and
+ * `b.co.uk` as the same site — but it is only ever used to make the sign-in
+ * test *stricter*, never to reject anything on its own.
+ */
+export function siteOf(url) {
+    try {
+        const { hostname } = new URL(url);
+        const labels = hostname.split('.');
+        return labels.length <= 2 ? hostname : labels.slice(-2).join('.');
+    }
+    catch {
+        return '';
+    }
+}
+/** Did the navigation end up on a different site than the one requested? */
+export function leftTheSite(requested, final) {
+    const from = siteOf(requested);
+    const to = siteOf(final);
+    return Boolean(from && to && from !== to);
+}
+/** Words that appear in the URL or title of a sign-in page and little else. */
+const SIGN_IN_URL = /(login|log-in|signin|sign-in|sso|oauth|authorize|authenticate)/i;
+const SIGN_IN_TITLE = /(sign[ -]?in|log[ -]?in|authentication required|authorization required|access denied)/i;
+/** Does this URL and title read as a sign-in page rather than a site's own page? */
+export function looksLikeSignIn(url, title = '') {
+    let path = '';
+    try {
+        const u = new URL(url);
+        path = u.pathname + u.search;
+    }
+    catch {
+        return false;
+    }
+    return SIGN_IN_URL.test(path) || SIGN_IN_TITLE.test(title);
+}
+/**
+ * Judge where a capture landed.
+ *
+ * Blocked requires *both* that the browser moved and that where it moved to is
+ * sign-in shaped: asking for `/login` and getting `/login` is not a wall, and
+ * neither is a plain canonical-domain redirect.
+ */
+export function checkLanding(requested, finalUrl, title = '') {
+    const moved = normalize(finalUrl) !== normalize(requested);
+    return {
+        finalUrl,
+        blocked: moved && looksLikeSignIn(finalUrl, title),
+        offSite: leftTheSite(requested, finalUrl),
+    };
+}
+/** Ignore the trailing-slash and fragment differences a redirect adds for free. */
+function normalize(url) {
+    try {
+        const u = new URL(url);
+        u.hash = '';
+        if (u.pathname.endsWith('/') && u.pathname !== '/')
+            u.pathname = u.pathname.slice(0, -1);
+        return u.toString();
+    }
+    catch {
+        return url;
+    }
+}
+/**
+ * The one sentence a human needs. Names the fix, not the symptom.
+ */
+export function signInHint(url, vercel) {
+    if (vercel) {
+        return `${url} answered with a sign-in page, so the site was never captured. ` +
+            'Set VERCEL_AUTOMATION_BYPASS_SECRET (Vercel → Project → Settings → Deployment Protection → Protection Bypass for Automation) and re-run.';
+    }
+    return `${url} answered with a sign-in page, so the site was never captured. ` +
+        `Run: npx pre-post login ${url}   (opens a browser once, saves the session locally)`;
+}
+//# sourceMappingURL=landing.js.map

package/dist/landing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"landing.js","sourceRoot":"","sources":["../src/landing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAC,GAAW;IAChC,IAAI,CAAC;QACH,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACnC,OAAO,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,WAAW,CAAC,SAAiB,EAAE,KAAa;IAC1D,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IAC/B,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACzB,OAAO,OAAO,CAAC,IAAI,IAAI,EAAE,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,+EAA+E;AAC/E,MAAM,WAAW,GAAG,iEAAiE,CAAC;AACtF,MAAM,aAAa,GAAG,wFAAwF,CAAC;AAE/G,oFAAoF;AACpF,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,KAAK,GAAG,EAAE;IACrD,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QACvB,IAAI,GAAG,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC7D,CAAC;AAWD;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,SAAiB,EAAE,QAAgB,EAAE,KAAK,GAAG,EAAE;IAC1E,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,KAAK,SAAS,CAAC,SAAS,CAAC,CAAC;IAC3D,OAAO;QACL,QAAQ;QACR,OAAO,EAAE,KAAK,IAAI,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC;QAClD,OAAO,EAAE,WAAW,CAAC,SAAS,EAAE,QAAQ,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED,mFAAmF;AACnF,SAAS,SAAS,CAAC,GAAW;IAC5B,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC;QACZ,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,KAAK,GAAG;YAAE,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACzF,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,MAAe;IACrD,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,GAAG,GAAG,iEAAiE;YAC5E,0IAA0I,CAAC;IAC/I,CAAC;IACD,OAAO,GAAG,GAAG,iEAAiE;QAC5E,2BAA2B,GAAG,sDAAsD,CAAC;AACzF,CAAC"}

package/dist/pkg.d.ts

@@ -0,0 +1,17 @@
+/**
+ * package.json access, shared by route detection and the pr command.
+ * Parsed once per file version (keyed by path + mtime), since detection asks
+ * the same question about the same root several times per run.
+ */
+export declare function readPackage(root: string): Record<string, any> | null;
+export declare function hasDependency(root: string, name: string): boolean;
+/**
+ * The script that starts a dev server for this package, preferring `dev`.
+ *
+ * This is the test for "is this directory an app we could actually serve?",
+ * used both when picking the app root to detect routes for and when serving a
+ * base commit. The two must agree: a directory that cannot be served is not
+ * the app a PR changed, however many of its files the diff touched.
+ */
+export declare function devScript(dir: string): string | null;
+//# sourceMappingURL=pkg.d.ts.map

package/dist/pkg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pkg.d.ts","sourceRoot":"","sources":["../src/pkg.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAkBpE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAGjE;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIpD"}

package/dist/pkg.js

@@ -0,0 +1,49 @@
+/**
+ * package.json access, shared by route detection and the pr command.
+ * Parsed once per file version (keyed by path + mtime), since detection asks
+ * the same question about the same root several times per run.
+ */
+import fs from 'fs';
+import path from 'path';
+const cache = new Map();
+export function readPackage(root) {
+    const file = path.join(root, 'package.json');
+    let mtimeMs;
+    try {
+        mtimeMs = fs.statSync(file).mtimeMs;
+    }
+    catch {
+        return null;
+    }
+    const hit = cache.get(file);
+    if (hit && hit.mtimeMs === mtimeMs)
+        return hit.pkg;
+    let pkg = null;
+    try {
+        pkg = JSON.parse(fs.readFileSync(file, 'utf-8'));
+    }
+    catch {
+        pkg = null;
+    }
+    cache.set(file, { mtimeMs, pkg });
+    return pkg;
+}
+export function hasDependency(root, name) {
+    const pkg = readPackage(root);
+    return Boolean(pkg?.dependencies?.[name] || pkg?.devDependencies?.[name]);
+}
+/**
+ * The script that starts a dev server for this package, preferring `dev`.
+ *
+ * This is the test for "is this directory an app we could actually serve?",
+ * used both when picking the app root to detect routes for and when serving a
+ * base commit. The two must agree: a directory that cannot be served is not
+ * the app a PR changed, however many of its files the diff touched.
+ */
+export function devScript(dir) {
+    const scripts = readPackage(dir)?.scripts;
+    if (!scripts)
+        return null;
+    return ['dev', 'start:dev', 'serve', 'start'].find(name => typeof scripts[name] === 'string') ?? null;
+}
+//# sourceMappingURL=pkg.js.map

package/dist/pkg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pkg.js","sourceRoot":"","sources":["../src/pkg.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,KAAK,GAAG,IAAI,GAAG,EAAgE,CAAC;AAEtF,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IAC7C,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,KAAK,OAAO;QAAE,OAAO,GAAG,CAAC,GAAG,CAAC;IACnD,IAAI,GAAG,GAA+B,IAAI,CAAC;IAC3C,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,GAAG,GAAG,IAAI,CAAC;IACb,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;IAClC,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,IAAY;IACtD,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,OAAO,CAAC,GAAG,EAAE,YAAY,EAAE,CAAC,IAAI,CAAC,IAAI,GAAG,EAAE,eAAe,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,EAAE,OAA6C,CAAC;IAChF,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,IAAI,IAAI,CAAC;AACxG,CAAC"}

package/dist/report.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Output formatting: the PR comment (for humans) and the terminal summary
+ * (for the developer or the agent that invoked the CLI).
+ */
+import { PrRunResult } from './types.js';
+export declare const STICKY_MARKER = "<!-- pre-post:visual-changes -->";
+export interface CommentOptions {
+    version?: string;
+    headSha?: string | null;
+    now?: Date;
+}
+/**
+ * Markdown body for the sticky PR comment.
+ */
+export declare function buildComment(result: PrRunResult, options?: CommentOptions): string;
+/**
+ * Compact terminal summary — designed to be the only thing an agent reads.
+ */
+export declare function buildSummary(result: PrRunResult): string;
+//# sourceMappingURL=report.d.ts.map

package/dist/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAuB,MAAM,YAAY,CAAC;AAI9D,eAAO,MAAM,aAAa,qCAAqC,CAAC;AAgBhE,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,GAAE,cAAmB,GAAG,MAAM,CA+EtF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CA6BxD"}

package/dist/report.js

@@ -0,0 +1,130 @@
+/**
+ * Output formatting: the PR comment (for humans) and the terminal summary
+ * (for the developer or the agent that invoked the CLI).
+ */
+import { describeShift } from './run.js';
+import { hostOf, isLocalUrl } from './url.js';
+export const STICKY_MARKER = '<!-- pre-post:visual-changes -->';
+function code(s) {
+    return `\`${s}\``;
+}
+function viewportLabel(v) {
+    return v.charAt(0).toUpperCase() + v.slice(1);
+}
+function groupByRoute(outcomes) {
+    const map = new Map();
+    for (const o of outcomes)
+        map.set(o.route, [...(map.get(o.route) ?? []), o]);
+    return map;
+}
+/**
+ * Markdown body for the sticky PR comment.
+ */
+export function buildComment(result, options = {}) {
+    const lines = [STICKY_MARKER, '## Visual changes', ''];
+    const routes = groupByRoute(result.outcomes);
+    const changed = result.outcomes.filter(o => o.status === 'changed');
+    const unchanged = result.outcomes.filter(o => o.status === 'unchanged');
+    const errors = result.outcomes.filter(o => o.status === 'error');
+    // A page that only one side has is still something a reviewer must see, so it
+    // counts as a change for "did anything happen" — but it is shown as one
+    // screenshot, never as a Pre/Post pair, because there is no pair.
+    const oneSided = result.outcomes.filter(o => (o.status === 'added' || o.status === 'removed') && (o.urls || o.files));
+    // Both sides can now be a deployment, so name the actual hosts rather than
+    // assuming Post is the reader's own checkout.
+    const postLabel = isLocalUrl(result.afterBase) ? 'this branch (local)' : hostOf(result.afterBase);
+    const sha = options.headSha ? ` @ ${code(options.headSha.slice(0, 7))}` : '';
+    lines.push(`**Pre** = ${hostOf(result.beforeBase)} · **Post** = ${postLabel}${sha} · <a href="https://github.com/juangadm/pre-post">pre-post</a>`, '');
+    if (changed.length === 0 && oneSided.length === 0)
+        lines.push('No visual changes.', '');
+    for (const [route, outcomes] of routes) {
+        const changedHere = outcomes.filter(o => o.status === 'changed' && (o.urls || o.files));
+        if (changedHere.length === 0)
+            continue;
+        for (const o of changedHere) {
+            const u = o.urls ?? o.files;
+            lines.push(`### ${code(route)} — ${viewportLabel(o.viewport)}`, '');
+            // A move repaints everything below it, so the percentage says nothing a
+            // reviewer can use. Say how far it moved instead, and whether the branch
+            // changed anything else.
+            if (o.shift) {
+                lines.push(o.shift.otherChange
+                    ? `Content ${describeShift(o.shift.px)}. The pair below is aligned on that move, so it shows what changed besides it.`
+                    : `Content ${describeShift(o.shift.px)}. Nothing else changed.`, '');
+            }
+            const cropped = Boolean(u.cropBefore && u.cropAfter);
+            const pre = u.cropBefore ?? u.before;
+            const post = u.cropAfter ?? u.after;
+            lines.push('| Pre | Post |', '|:---:|:---:|', `| ![Pre](${pre}) | ![Post](${post}) |`, '');
+            // Without a crop the pair above is already the full page; repeating it
+            // under a fold gives a reviewer two more identical images to scroll past.
+            if (cropped) {
+                lines.push('<details>', `<summary>Full page</summary>`, '');
+                lines.push('| Pre (full) | Post (full) |', '|:---:|:---:|', `| ![Pre full](${u.before}) | ![Post full](${u.after}) |`, '');
+                lines.push('</details>', '');
+            }
+        }
+    }
+    for (const o of oneSided) {
+        const u = o.urls ?? o.files;
+        const image = o.status === 'added' ? u.after : u.before;
+        if (!image)
+            continue;
+        const what = o.status === 'added' ? 'New page' : 'Page removed';
+        const side = o.status === 'added' ? 'Post' : 'Pre';
+        lines.push(`### ${code(o.route)} — ${viewportLabel(o.viewport)} · ${what}`, '');
+        lines.push(o.status === 'added'
+            ? `This route has no baseline — ${hostOf(result.beforeBase)} returns 404 for it — so there is no "before" to show and no percentage to quote. ${side} only:`
+            : `This route is gone on this branch, so there is no "after". ${side} only:`, '');
+        lines.push(`![${side}](${image})`, '');
+    }
+    if (unchanged.length) {
+        const byRoute = groupByRoute(unchanged);
+        const parts = Array.from(byRoute.entries()).map(([route, os]) => `${code(route)} (${os.map(o => o.viewport).join(', ')})`);
+        lines.push(`**No visual change:** ${parts.join(' · ')}`, '');
+    }
+    if (errors.length) {
+        lines.push('**Could not capture:**');
+        for (const o of errors)
+            lines.push(`- ${code(o.route)} ${o.viewport}: ${o.error}`);
+        lines.push('');
+    }
+    if (result.skippedDynamic.length) {
+        lines.push(`**Needs a sample URL:** ${result.skippedDynamic.map(code).join(', ')} — add them under ${code('"samples"')} in ${code('.pre-post.json')}.`, '');
+    }
+    return lines.join('\n');
+}
+/**
+ * Compact terminal summary — designed to be the only thing an agent reads.
+ */
+export function buildSummary(result) {
+    const lines = [];
+    const header = [
+        result.prNumber ? `PR #${result.prNumber}` : 'no PR',
+        `${new Set(result.outcomes.map(o => o.route)).size} route(s)`,
+        `${new Set(result.outcomes.map(o => o.viewport)).size} viewport(s)`,
+        `${(result.durationMs / 1000).toFixed(1)}s`,
+    ];
+    lines.push(`pre-post · ${header.join(' · ')}`);
+    const rows = result.outcomes.map(o => [
+        o.route,
+        o.viewport,
+        o.status === 'error' ? 'error'
+            : o.status === 'changed' ? 'changed'
+                : o.status === 'added' ? 'new page'
+                    : o.status === 'removed' ? 'removed'
+                        : 'no change',
+        o.status === 'error' ? (o.error ?? '') : (o.note || ''),
+    ]);
+    const widths = [0, 1, 2].map(i => Math.max(...rows.map(r => r[i].length), 0));
+    for (const r of rows) {
+        lines.push(`  ${r[0].padEnd(widths[0])}  ${r[1].padEnd(widths[1])}  ${r[2].padEnd(widths[2])}  ${r[3]}`.trimEnd());
+    }
+    if (result.skippedDynamic.length) {
+        lines.push(`  needs sample URL: ${result.skippedDynamic.join(', ')} (add to .pre-post.json "samples")`);
+    }
+    if (result.commentUrl)
+        lines.push(`Comment: ${result.commentUrl}`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=report.js.map

package/dist/report.js.map

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

package/dist/routes/imports.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Lightweight import graph. Regex-based (no TypeScript compiler), fast enough
+ * to scan a few thousand files in well under a second, and good enough to
+ * answer "which page files transitively import this changed file?".
+ */
+export declare const SOURCE_EXTENSIONS: string[];
+export declare const SKIP_DIRS: Set<string>;
+export declare function toPosix(p: string): string;
+export interface ImportGraph {
+    /** Absolute paths of every scanned source file */
+    files: Set<string>;
+    /** file → files that import it (absolute paths) */
+    importers: Map<string, Set<string>>;
+}
+export interface Alias {
+    /** Prefix such as "@/" or "~/" */
+    prefix: string;
+    /** Absolute directories to try, in order */
+    targets: string[];
+}
+/**
+ * Read path aliases from tsconfig.json / jsconfig.json (one level of `extends`).
+ */
+export declare function readAliases(appRoot: string): Alias[];
+export declare function resolveSpecifier(spec: string, fromFile: string, files: Set<string>, aliases: Alias[]): string | null;
+export declare function walkSourceFiles(root: string, maxFiles?: number): string[];
+export declare function extractSpecifiers(source: string): string[];
+/**
+ * Build the reverse import graph for every source file under `appRoot`.
+ */
+export declare function buildImportGraph(appRoot: string, options?: {
+    files?: string[];
+    aliases?: Alias[];
+}): ImportGraph;
+export interface AffectedEntry {
+    /** The changed file that led here */
+    via: string;
+    /** Number of import hops from the changed file (0 = the entry itself changed) */
+    depth: number;
+}
+/**
+ * Walk importers from each changed file until entry files are reached.
+ * Returns entry → closest (changed file, depth).
+ */
+export declare function findAffectedEntries(graph: ImportGraph, changed: string[], isEntry: (file: string) => boolean, maxDepth?: number): Map<string, AffectedEntry>;
+//# sourceMappingURL=imports.d.ts.map

package/dist/routes/imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imports.d.ts","sourceRoot":"","sources":["../../src/routes/imports.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,eAAO,MAAM,iBAAiB,UAA6G,CAAC;AAG5I,eAAO,MAAM,SAAS,aAGpB,CAAC;AAEH,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED,MAAM,WAAW,WAAW;IAC1B,kDAAkD;IAClD,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACnB,mDAAmD;IACnD,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,KAAK;IACpB,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAqBD;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,EAAE,CAuCpD;AAcD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,GAAG,IAAI,CAiBpH;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,SAAO,GAAG,MAAM,EAAE,CAoBvE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAQ1D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAA;CAAO,GAAG,WAAW,CAsBpH;AAED,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,EAClC,QAAQ,SAAI,GACX,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAyB5B"}

package/dist/routes/imports.js

@@ -0,0 +1,208 @@
+/**
+ * Lightweight import graph. Regex-based (no TypeScript compiler), fast enough
+ * to scan a few thousand files in well under a second, and good enough to
+ * answer "which page files transitively import this changed file?".
+ */
+import fs from 'fs';
+import path from 'path';
+export const SOURCE_EXTENSIONS = ['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs', '.mts', '.cts', '.vue', '.svelte', '.astro', '.mdx', '.md'];
+const RESOLVE_EXTENSIONS = ['.tsx', '.ts', '.jsx', '.js', '.mjs', '.cjs', '.mts', '.cts', '.vue', '.svelte', '.astro', '.mdx', '.md', '.css', '.scss', '.json'];
+export const SKIP_DIRS = new Set([
+    '.git', '.next', '.nuxt', '.svelte-kit', '.turbo', '.vercel', '.cache', 'node_modules',
+    'dist', 'build', 'out', 'coverage', 'public', 'storybook-static', '.storybook', '__snapshots__',
+]);
+export function toPosix(p) {
+    return p.split(path.sep).join('/');
+}
+const SPECIFIER_PATTERNS = [
+    /(?:^|[^\w$.])(?:import|export)\s+(?:type\s+)?(?:[\w*{}\s,$]+?\s+from\s+)?['"]([^'"\n]+)['"]/g,
+    /import\s*\(\s*['"]([^'"\n]+)['"]\s*\)/g,
+    /require\s*\(\s*['"]([^'"\n]+)['"]\s*\)/g,
+];
+/** Very lenient JSON parse for tsconfig/jsconfig (comments + trailing commas). */
+function parseJsonc(text) {
+    const stripped = text
+        .replace(/\/\*[\s\S]*?\*\//g, '')
+        .replace(/(^|[^:\\])\/\/.*$/gm, '$1')
+        .replace(/,\s*([}\]])/g, '$1');
+    try {
+        return JSON.parse(stripped);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Read path aliases from tsconfig.json / jsconfig.json (one level of `extends`).
+ */
+export function readAliases(appRoot) {
+    const aliases = [];
+    const seen = new Set();
+    const visit = (file, depth) => {
+        if (depth > 2 || seen.has(file) || !fs.existsSync(file))
+            return;
+        seen.add(file);
+        const cfg = parseJsonc(fs.readFileSync(file, 'utf-8'));
+        if (!cfg)
+            return;
+        const dir = path.dirname(file);
+        const baseUrl = cfg.compilerOptions?.baseUrl ? path.resolve(dir, cfg.compilerOptions.baseUrl) : dir;
+        const paths = cfg.compilerOptions?.paths || {};
+        for (const [pattern, targets] of Object.entries(paths)) {
+            const prefix = pattern.replace(/\*$/, '');
+            aliases.push({
+                prefix,
+                targets: (targets || []).map(t => path.resolve(baseUrl, t.replace(/\*$/, ''))),
+            });
+        }
+        if (cfg.compilerOptions?.baseUrl) {
+            aliases.push({ prefix: '', targets: [baseUrl] });
+        }
+        if (typeof cfg.extends === 'string' && cfg.extends.startsWith('.')) {
+            visit(path.resolve(dir, cfg.extends.endsWith('.json') ? cfg.extends : `${cfg.extends}.json`), depth + 1);
+        }
+    };
+    visit(path.join(appRoot, 'tsconfig.json'), 0);
+    visit(path.join(appRoot, 'jsconfig.json'), 0);
+    // Common conventions even without tsconfig paths.
+    for (const conv of ['@/', '~/']) {
+        if (!aliases.some(a => a.prefix === conv)) {
+            const targets = [path.join(appRoot, 'src'), appRoot].filter(d => fs.existsSync(d));
+            aliases.push({ prefix: conv, targets });
+        }
+    }
+    // Longest prefix first; the bare baseUrl fallback last.
+    return aliases.sort((a, b) => b.prefix.length - a.prefix.length);
+}
+function resolveFile(base, files) {
+    if (files.has(base))
+        return base;
+    for (const ext of RESOLVE_EXTENSIONS) {
+        if (files.has(base + ext))
+            return base + ext;
+    }
+    for (const ext of RESOLVE_EXTENSIONS) {
+        const idx = path.join(base, `index${ext}`);
+        if (files.has(idx))
+            return idx;
+    }
+    return null;
+}
+export function resolveSpecifier(spec, fromFile, files, aliases) {
+    const clean = spec.split('?')[0].split('#')[0];
+    if (!clean)
+        return null;
+    if (clean.startsWith('.') || clean.startsWith('/')) {
+        const base = clean.startsWith('/') ? clean : path.resolve(path.dirname(fromFile), clean);
+        return resolveFile(base, files);
+    }
+    for (const alias of aliases) {
+        if (alias.prefix && !clean.startsWith(alias.prefix))
+            continue;
+        if (!alias.prefix && (clean.startsWith('@') || !/^[\w-]+[/]/.test(clean) && !/^[\w-]+$/.test(clean)))
+            continue;
+        const rest = clean.slice(alias.prefix.length);
+        for (const target of alias.targets) {
+            const found = resolveFile(path.join(target, rest), files);
+            if (found)
+                return found;
+        }
+    }
+    return null;
+}
+export function walkSourceFiles(root, maxFiles = 8000) {
+    const out = [];
+    const stack = [root];
+    while (stack.length && out.length < maxFiles) {
+        const dir = stack.pop();
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                if (!SKIP_DIRS.has(entry.name) && !entry.name.startsWith('.'))
+                    stack.push(path.join(dir, entry.name));
+            }
+            else if (entry.isFile() && SOURCE_EXTENSIONS.includes(path.extname(entry.name))) {
+                out.push(path.join(dir, entry.name));
+            }
+        }
+    }
+    return out;
+}
+export function extractSpecifiers(source) {
+    const specs = [];
+    for (const pattern of SPECIFIER_PATTERNS) {
+        pattern.lastIndex = 0;
+        let m;
+        while ((m = pattern.exec(source)))
+            specs.push(m[1]);
+    }
+    return specs;
+}
+/**
+ * Build the reverse import graph for every source file under `appRoot`.
+ */
+export function buildImportGraph(appRoot, options = {}) {
+    const list = options.files ?? walkSourceFiles(appRoot);
+    const files = new Set(list);
+    const aliases = options.aliases ?? readAliases(appRoot);
+    const importers = new Map();
+    for (const file of list) {
+        let source;
+        try {
+            source = fs.readFileSync(file, 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        for (const spec of extractSpecifiers(source)) {
+            const target = resolveSpecifier(spec, file, files, aliases);
+            if (!target || target === file)
+                continue;
+            let set = importers.get(target);
+            if (!set)
+                importers.set(target, (set = new Set()));
+            set.add(file);
+        }
+    }
+    return { files, importers };
+}
+/**
+ * Walk importers from each changed file until entry files are reached.
+ * Returns entry → closest (changed file, depth).
+ */
+export function findAffectedEntries(graph, changed, isEntry, maxDepth = 8) {
+    const result = new Map();
+    const record = (entry, via, depth) => {
+        const existing = result.get(entry);
+        if (!existing || depth < existing.depth)
+            result.set(entry, { via, depth });
+    };
+    for (const origin of changed) {
+        const visited = new Set([origin]);
+        let frontier = [origin];
+        if (isEntry(origin))
+            record(origin, origin, 0);
+        for (let depth = 1; depth <= maxDepth && frontier.length; depth++) {
+            const next = [];
+            for (const file of frontier) {
+                for (const importer of graph.importers.get(file) ?? []) {
+                    if (visited.has(importer))
+                        continue;
+                    visited.add(importer);
+                    if (isEntry(importer))
+                        record(importer, origin, depth);
+                    next.push(importer);
+                }
+            }
+            frontier = next;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=imports.js.map