@ia-qa/self-healing 1.6.6 → 1.6.8

package/dist/evidence.js

@@ -0,0 +1,232 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CROP_MAX_WIDTH = exports.CROP_PADDING = void 0;
+exports.loadPageShot = loadPageShot;
+exports.cropWindow = cropWindow;
+exports.ambiguousCandidates = ambiguousCandidates;
+exports.rowEvidence = rowEvidence;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const config_1 = require("./config");
+const match_1 = require("./browser/match");
+/**
+ * Visual evidence for the rows a human has to decide — the decision-grade half
+ * of SPEC-visual-evidence.md layer 1.
+ *
+ * The measured problem this exists for: `ambiguous` rows are 10 % of elements on
+ * a dogfooded corpus and 20 % in the wild, and all the report could say about
+ * one was `div:nth-of-type(4) > … > button`. The human is not missing a
+ * description of what they were looking for — the row already says
+ * `button "Copy"` — they are missing *which of the N identical candidates* is
+ * the one. That question has exactly one cheap answer: show them, highlighted.
+ *
+ * Three constraints shape everything below.
+ *
+ * 1. **No pixel is ever an input to a verdict.** This module is called only when
+ *    rendering HTML. `diffMappings` never sees it, no counter moves, and a
+ *    report generated with no screenshots on disk is byte-identical to one from
+ *    before the feature (a test pins that).
+ * 2. **No image is decoded in Node.** There is no PNG/JPEG codec here and no
+ *    dependency to add one. A crop is a *CSS window* onto the page screenshot:
+ *    the JPEG is emitted once per page as a `background-image`, and every
+ *    thumbnail is a box with a negative background offset. N crops of one page
+ *    therefore cost the bytes of one picture.
+ * 3. **A crop with no marker on the target is worse than no crop** — study D,
+ *    measured on real captures. Six identical upvote arrows tell a human
+ *    nothing about which one drifted. So the highlight is not decoration and is
+ *    never optional: if the rect is unknown, the crop is not rendered at all.
+ */
+/** Pixels of page context kept around the element. 120 is the value study D found legible. */
+exports.CROP_PADDING = 120;
+/** Widest a thumbnail may render; wider windows are scaled down, never cropped further. */
+exports.CROP_MAX_WIDTH = 360;
+/**
+ * Load the screenshot and the element positions `map --screenshots` wrote for a
+ * page. Either half missing — flag never used, page skipped, old capture — means
+ * no evidence for that page and nothing else: every caller degrades to the
+ * report as it was.
+ */
+function loadPageShot(pageName, dir = safeShotsDir()) {
+    if (!dir)
+        return null;
+    const safe = pageName.replace(/[^a-zA-Z0-9._-]/g, '-');
+    const jpg = path.join(dir, `${safe}.jpg`);
+    const rectsFile = path.join(dir, `${safe}.rects.json`);
+    try {
+        if (!fs.existsSync(jpg) || !fs.existsSync(rectsFile))
+            return null;
+        const parsed = JSON.parse(fs.readFileSync(rectsFile, 'utf8'));
+        if (!parsed.rects || !parsed.viewport)
+            return null;
+        const b64 = fs.readFileSync(jpg).toString('base64');
+        return {
+            dataUri: `data:image/jpeg;base64,${b64}`,
+            viewport: parsed.viewport,
+            rects: parsed.rects,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function safeShotsDir() {
+    try {
+        return (0, config_1.shotsDir)();
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * The CSS window onto the page image for one element: a box of `rect ± padding`,
+ * clamped to the picture's bounds, plus where the target sits inside it.
+ *
+ * Pure arithmetic — same inputs, same output, no I/O — which is what lets a test
+ * pin it without a browser (AC-13's spirit: the crop is a function, not a
+ * capture).
+ */
+function cropWindow(rect, viewport, padding = exports.CROP_PADDING, maxWidth = exports.CROP_MAX_WIDTH) {
+    const [x, y, w, h] = rect;
+    const winW = Math.min(viewport.w, w + padding * 2);
+    const winH = Math.min(viewport.h, h + padding * 2);
+    const offsetX = Math.max(0, Math.min(viewport.w - winW, Math.round(x - (winW - w) / 2)));
+    const offsetY = Math.max(0, Math.min(viewport.h - winH, Math.round(y - (winH - h) / 2)));
+    const scale = Math.min(1, maxWidth / winW);
+    return {
+        width: Math.round(winW * scale),
+        height: Math.round(winH * scale),
+        scale,
+        offsetX,
+        offsetY,
+        hi: { left: x - offsetX, top: y - offsetY, width: w, height: h },
+    };
+}
+/**
+ * The elements an `ambiguous` row could not be told apart from.
+ *
+ * `matchElement` returns only a *count* — it decides, or refuses, and the
+ * refusal carries no list. Rather than widen its return type, this re-derives
+ * the same set from the same primitives on the "after" side. That choice is not
+ * stylistic: `src/browser/match.js` ships twice (npm and the web tool on
+ * ia-qa.com), so every change to it owes two deploys and risks the two copies
+ * disagreeing about a verdict. Reporting is allowed to import *from* the
+ * matcher; it is not allowed to change it — the same rule the AI layer follows.
+ *
+ * The tiers mirror `matchElement` exactly: exact accessible-name matches first,
+ * then the fuzzy band within 0.05 of the top Dice score.
+ *
+ * One case it cannot reproduce, on purpose: a row demoted to `ambiguous` by the
+ * many-to-one guard (N baseline elements all healing onto one target) has a
+ * `candidateCount` counting *baseline rows*, not live elements. There, this
+ * returns the single contested target, which is the useful thing to look at.
+ */
+function ambiguousCandidates(row, after) {
+    const sameRole = after.filter((c) => c.role === row.role);
+    const wanted = (0, match_1.normalize)(row.name);
+    const wantedCtx = (0, match_1.normalize)(row.context);
+    const pick = (cands) => {
+        if (cands.length <= 1)
+            return cands;
+        if (wantedCtx) {
+            const byCtx = cands.filter((c) => (0, match_1.normalize)(c.context) === wantedCtx);
+            if (byCtx.length === 1)
+                return byCtx;
+        }
+        return cands;
+    };
+    const exact = sameRole.filter((c) => (0, match_1.normalize)(c.name) === wanted && wanted !== '');
+    if (exact.length > 0)
+        return pick(exact).map(toCandidate);
+    const scored = sameRole
+        .map((c) => ({ c, score: (0, match_1.diceSimilarity)((0, match_1.normalize)(c.name), wanted) }))
+        .filter((s) => s.score >= match_1.FUZZY_THRESHOLD)
+        .sort((a, b) => b.score - a.score);
+    if (scored.length === 0)
+        return [];
+    const top = scored[0].score;
+    const tied = scored.filter((s) => top - s.score < 0.05).map((s) => s.c);
+    return pick(tied).map(toCandidate);
+}
+function toCandidate(e) {
+    return { selector: e.selector, name: e.name, role: e.role, context: e.context };
+}
+/**
+ * Assemble the evidence for one drifted row.
+ *
+ * Only the statuses where a human is actually stuck get pictures — `ambiguous`,
+ * and anything `rebound`. `ok`, `renamed` and `healable` are deliberately left
+ * bare: there is no decision to take on them, so a thumbnail would be weight
+ * without a question (F1.8).
+ */
+function rowEvidence(row, after, shot) {
+    if (!shot || !after)
+        return null;
+    const wants = row.status === 'ambiguous' || row.rebound === true;
+    if (!wants)
+        return null;
+    const locate = (selector, label) => {
+        const rect = shot.rects[selector];
+        // No rect means the element was below the fold or absent when the picture
+        // was taken. Showing the crop anyway would highlight empty space — exactly
+        // the misleading thumbnail study D rules out.
+        if (!rect)
+            return null;
+        return { selector, label, crop: cropWindow(rect, shot.viewport) };
+    };
+    const out = { candidates: [] };
+    if (row.rebound) {
+        const hit = locate(row.selector, `${row.role} "${row.reboundTo ?? ''}"`);
+        if (hit)
+            out.nowAt = hit;
+    }
+    if (row.status === 'ambiguous') {
+        for (const c of ambiguousCandidates(row, after.elements)) {
+            const located = locate(c.selector, c.name ? `${c.role} "${c.name}"` : `${c.role} (no name)`);
+            if (located)
+                out.candidates.push(located);
+        }
+    }
+    if (!out.nowAt && out.candidates.length === 0) {
+        return {
+            candidates: [],
+            note: row.status === 'ambiguous'
+                ? 'No picture for these candidates — they were below the fold when the page was captured.'
+                : 'No picture for this element — it was below the fold when the page was captured.',
+        };
+    }
+    return out;
+}
+//# sourceMappingURL=evidence.js.map

package/dist/evidence.js.map

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

package/dist/history.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Append-only run history — `.ia-qa/history.jsonl`.
+ *
+ * Every other verb in this package is *stateless*: `diff` compares two moments
+ * and forgets. That is the right shape for a gate, and it is also why the tool
+ * can never answer the question a QA lead actually asks — "is this getting
+ * better or worse?". A trend is not derivable from any single invocation, so it
+ * has to be recorded as it happens; unlike a verdict, it cannot be recomputed
+ * after the fact. Every run not written down is a data point that will never
+ * exist.
+ *
+ * Three rules keep this from becoming a dashboard that lies:
+ *
+ * 1. **It never influences a verdict.** Nothing reads history back into a diff.
+ *    It is written after the exit code is decided, and a failure to write is
+ *    swallowed — a full disk must not turn a PASS into a crash.
+ * 2. **Every entry carries what makes it comparable** — `source` (`map` vs a
+ *    live `run` capture) and `coverage` (pages measured / pages mapped). Two
+ *    entries that disagree on either are not two points on one curve, and
+ *    `trendable()` below is what refuses to draw them as one.
+ * 3. **It is small and deterministic.** Verdicts and counters, no pixels, no
+ *    element contents. Unlike `_shots/`, committing this file is defensible —
+ *    it is a few kB of text that changes by one line per run.
+ */
+export declare const HISTORY_FILENAME = "history.jsonl";
+/** Entries kept on disk. Older ones are dropped on write — a trend does not need a year. */
+export declare const HISTORY_LIMIT = 500;
+export interface HistoryCounts {
+    total: number;
+    ok: number;
+    renamed: number;
+    healable: number;
+    ambiguous: number;
+    lost: number;
+    rebound: number;
+    added: number;
+}
+export interface HistoryEntry {
+    /** ISO-8601, stamped at write time. */
+    ts: string;
+    verb: 'diff' | 'run' | 'fix' | 'audit' | 'check';
+    /** The verb's own verdict word — PASS/FIX/BLOCK for the drift verbs, OK/WARN/FAIL for `check`. */
+    verdict: string;
+    /** Element-level counters. Absent for verbs that do not diff (`audit`, `check`, bare `fix`). */
+    counts?: HistoryCounts;
+    /**
+     * How the *current* side was captured. `mixed` means the pages did not agree —
+     * the same source mismatch `run` warns about, recorded rather than inferred.
+     */
+    source?: 'map' | 'run' | 'mixed';
+    /** Pages that produced a verdict / pages mapped. A green run over 1 of 40 pages is not a green app. */
+    coverage?: {
+        measured: number;
+        total: number;
+    };
+    nameDrift?: {
+        total: number;
+        manual: number;
+    };
+    /** Only pages that actually drifted, so a 200-page app still writes a short line. */
+    pages?: Array<{
+        name: string;
+        drift: number;
+    }>;
+    baseUrl?: string;
+    commit?: string;
+    branch?: string;
+    /** What `fix`/`run` wrote to the test files. */
+    applied?: {
+        replacements: number;
+        files: number;
+    };
+    /** The post-fix re-run of the user's suite, when `run` performed one. */
+    verify?: 'PASS' | 'FAIL' | 'SKIPPED';
+    /** Findings, for the verbs that produce findings rather than diff rows. */
+    findings?: number;
+}
+export declare function historyPath(cwd?: string): string;
+/**
+ * Append one entry. Best-effort by design: history is an observation of the run,
+ * never part of it, so every failure mode here (read-only checkout, missing
+ * directory, full disk, concurrent writer) costs the data point and nothing else.
+ */
+export declare function appendHistory(entry: Omit<HistoryEntry, 'ts'> & {
+    ts?: string;
+}): void;
+/**
+ * Read the history, oldest first. A malformed line is skipped rather than fatal:
+ * this file is appended to by every run and may be truncated mid-write by a
+ * killed process, and one bad line must not cost the other 499.
+ */
+export declare function readHistory(limit?: number, cwd?: string): HistoryEntry[];
+/**
+ * Which entries may be drawn as one curve.
+ *
+ * This is the whole reason the store carries `source`. A `map` baseline and a
+ * live `run` capture read the same page differently — the CLI already warns
+ * about diffing one against the other — so plotting both on one axis manufactures
+ * a trend out of a capture artifact. The same applies to coverage: a run that
+ * measured 1 of 40 pages and one that measured 40 are not comparable magnitudes,
+ * so entries below `minCoverage` of the largest observed coverage are held out.
+ *
+ * The excluded entries are returned, not discarded, so the caller can *say* what
+ * it left out. A chart that silently drops half its data is the dashboard-that-
+ * lies failure mode this function exists to prevent.
+ */
+export interface Trend {
+    series: HistoryEntry[];
+    excluded: HistoryEntry[];
+    /** Present when anything was held out — render it next to the chart, never swallow it. */
+    reason?: string;
+    /** The capture source the series is drawn from. */
+    source?: 'map' | 'run' | 'mixed';
+}
+export declare function trendable(entries: HistoryEntry[], minCoverage?: number): Trend;
+export interface HistorySummary {
+    runs: number;
+    first?: string;
+    last?: string;
+    lastVerdict?: string;
+    /** Share of comparable runs that were not PASS. */
+    driftRate: number;
+    /** Mean measured/total across the comparable series, or 1 when nothing recorded coverage. */
+    coverage: number;
+    /** Pages ranked by how many runs they drifted in — where the churn actually lives. */
+    hotspots: Array<{
+        name: string;
+        runs: number;
+        drift: number;
+    }>;
+    /** Rewrites the tool applied across the whole history. */
+    healed: number;
+    trend: Trend;
+}
+export declare function summarize(entries: HistoryEntry[]): HistorySummary;
+/**
+ * Best-effort git stamp. A trend of verdicts is far more useful when a spike can
+ * be tied to a commit, and every alternative (asking the user to pass it, reading
+ * CI env vars per provider) is worse than shelling out once. Never throws, never
+ * blocks: no git, no repo, detached HEAD — the entry is written without it.
+ */
+export declare function gitStamp(): {
+    commit?: string;
+    branch?: string;
+};

package/dist/history.js

@@ -0,0 +1,230 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HISTORY_LIMIT = exports.HISTORY_FILENAME = void 0;
+exports.historyPath = historyPath;
+exports.appendHistory = appendHistory;
+exports.readHistory = readHistory;
+exports.trendable = trendable;
+exports.summarize = summarize;
+exports.gitStamp = gitStamp;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const config_1 = require("./config");
+/**
+ * Append-only run history — `.ia-qa/history.jsonl`.
+ *
+ * Every other verb in this package is *stateless*: `diff` compares two moments
+ * and forgets. That is the right shape for a gate, and it is also why the tool
+ * can never answer the question a QA lead actually asks — "is this getting
+ * better or worse?". A trend is not derivable from any single invocation, so it
+ * has to be recorded as it happens; unlike a verdict, it cannot be recomputed
+ * after the fact. Every run not written down is a data point that will never
+ * exist.
+ *
+ * Three rules keep this from becoming a dashboard that lies:
+ *
+ * 1. **It never influences a verdict.** Nothing reads history back into a diff.
+ *    It is written after the exit code is decided, and a failure to write is
+ *    swallowed — a full disk must not turn a PASS into a crash.
+ * 2. **Every entry carries what makes it comparable** — `source` (`map` vs a
+ *    live `run` capture) and `coverage` (pages measured / pages mapped). Two
+ *    entries that disagree on either are not two points on one curve, and
+ *    `trendable()` below is what refuses to draw them as one.
+ * 3. **It is small and deterministic.** Verdicts and counters, no pixels, no
+ *    element contents. Unlike `_shots/`, committing this file is defensible —
+ *    it is a few kB of text that changes by one line per run.
+ */
+exports.HISTORY_FILENAME = 'history.jsonl';
+/** Entries kept on disk. Older ones are dropped on write — a trend does not need a year. */
+exports.HISTORY_LIMIT = 500;
+function historyPath(cwd = (0, config_1.baseDir)()) {
+    return path.join(cwd, config_1.CONFIG_DIR, exports.HISTORY_FILENAME);
+}
+/**
+ * Append one entry. Best-effort by design: history is an observation of the run,
+ * never part of it, so every failure mode here (read-only checkout, missing
+ * directory, full disk, concurrent writer) costs the data point and nothing else.
+ */
+function appendHistory(entry) {
+    const file = historyPath();
+    const full = { ts: entry.ts ?? new Date().toISOString(), ...entry };
+    try {
+        fs.mkdirSync(path.dirname(file), { recursive: true });
+        fs.appendFileSync(file, JSON.stringify(full) + '\n', 'utf8');
+        truncate(file);
+    }
+    catch {
+        /* history is a courtesy, never a gate */
+    }
+}
+/** Keep the file bounded without a second config knob nobody would ever tune. */
+function truncate(file) {
+    try {
+        const lines = fs.readFileSync(file, 'utf8').split('\n').filter(Boolean);
+        if (lines.length <= exports.HISTORY_LIMIT + 100)
+            return;
+        fs.writeFileSync(file, lines.slice(-exports.HISTORY_LIMIT).join('\n') + '\n', 'utf8');
+    }
+    catch {
+        /* as above */
+    }
+}
+/**
+ * Read the history, oldest first. A malformed line is skipped rather than fatal:
+ * this file is appended to by every run and may be truncated mid-write by a
+ * killed process, and one bad line must not cost the other 499.
+ */
+function readHistory(limit = exports.HISTORY_LIMIT, cwd) {
+    const file = cwd ? path.join(cwd, config_1.CONFIG_DIR, exports.HISTORY_FILENAME) : historyPath();
+    let raw;
+    try {
+        raw = fs.readFileSync(file, 'utf8');
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const line of raw.split('\n')) {
+        if (!line.trim())
+            continue;
+        try {
+            const parsed = JSON.parse(line);
+            if (parsed && typeof parsed.ts === 'string' && typeof parsed.verb === 'string')
+                out.push(parsed);
+        }
+        catch {
+            /* skip */
+        }
+    }
+    return out.slice(-limit);
+}
+function trendable(entries, minCoverage = 0.5) {
+    const drift = entries.filter((e) => e.counts && (e.verb === 'diff' || e.verb === 'run'));
+    if (drift.length === 0)
+        return { series: [], excluded: [] };
+    // Dominant capture source wins the axis; the minority is held out rather than
+    // averaged in. Ties go to the most recent, which is what the user is looking at.
+    const bySource = new Map();
+    for (const e of drift)
+        bySource.set(e.source ?? 'map', (bySource.get(e.source ?? 'map') ?? 0) + 1);
+    let source = 'map';
+    let best = -1;
+    for (const [s, n] of bySource) {
+        if (n > best) {
+            best = n;
+            source = s;
+        }
+    }
+    const sourceKept = drift.filter((e) => (e.source ?? 'map') === source);
+    const sourceDropped = drift.filter((e) => (e.source ?? 'map') !== source);
+    const maxCov = Math.max(...sourceKept.map((e) => (e.coverage ? e.coverage.measured / Math.max(1, e.coverage.total) : 1)));
+    const series = sourceKept.filter((e) => {
+        if (!e.coverage)
+            return true;
+        return e.coverage.measured / Math.max(1, e.coverage.total) >= maxCov * minCoverage;
+    });
+    const covDropped = sourceKept.filter((e) => !series.includes(e));
+    const excluded = [...sourceDropped, ...covDropped];
+    const parts = [];
+    if (sourceDropped.length > 0) {
+        parts.push(`${sourceDropped.length} run${sourceDropped.length === 1 ? '' : 's'} captured a different way ` +
+            `(a \`map\` capture and a live suite capture read a page differently)`);
+    }
+    if (covDropped.length > 0) {
+        parts.push(`${covDropped.length} run${covDropped.length === 1 ? '' : 's'} covered too few pages to compare`);
+    }
+    return {
+        series,
+        excluded,
+        source,
+        reason: parts.length > 0 ? `Left out of the trend: ${parts.join('; ')}.` : undefined,
+    };
+}
+function summarize(entries) {
+    const trend = trendable(entries);
+    const s = trend.series;
+    const notPass = s.filter((e) => e.verdict !== 'PASS').length;
+    const withCov = s.filter((e) => e.coverage);
+    const coverage = withCov.length === 0
+        ? 1
+        : withCov.reduce((n, e) => n + e.coverage.measured / Math.max(1, e.coverage.total), 0) / withCov.length;
+    const pageStats = new Map();
+    for (const e of s) {
+        for (const p of e.pages ?? []) {
+            const cur = pageStats.get(p.name) ?? { runs: 0, drift: 0 };
+            cur.runs += 1;
+            cur.drift += p.drift;
+            pageStats.set(p.name, cur);
+        }
+    }
+    const hotspots = [...pageStats.entries()]
+        .map(([name, v]) => ({ name, ...v }))
+        .sort((a, b) => b.drift - a.drift || b.runs - a.runs)
+        .slice(0, 5);
+    return {
+        runs: entries.length,
+        first: entries[0]?.ts,
+        last: entries[entries.length - 1]?.ts,
+        lastVerdict: entries[entries.length - 1]?.verdict,
+        driftRate: s.length === 0 ? 0 : notPass / s.length,
+        coverage,
+        hotspots,
+        healed: entries.reduce((n, e) => n + (e.applied?.replacements ?? 0), 0),
+        trend,
+    };
+}
+/**
+ * Best-effort git stamp. A trend of verdicts is far more useful when a spike can
+ * be tied to a commit, and every alternative (asking the user to pass it, reading
+ * CI env vars per provider) is worse than shelling out once. Never throws, never
+ * blocks: no git, no repo, detached HEAD — the entry is written without it.
+ */
+function gitStamp() {
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    const { execFileSync } = require('child_process');
+    const run = (args) => {
+        try {
+            const out = execFileSync('git', args, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'], timeout: 2000 });
+            const v = out.trim();
+            return v === '' ? undefined : v;
+        }
+        catch {
+            return undefined;
+        }
+    };
+    return { commit: run(['rev-parse', '--short', 'HEAD']), branch: run(['rev-parse', '--abbrev-ref', 'HEAD']) };
+}
+//# sourceMappingURL=history.js.map

package/dist/history.js.map

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