tinybeeai 0.0.0-stage → 0.16.1

package/dist/flows/testRepo.js

@@ -0,0 +1,228 @@
+// The Tests repo batch of pr_check and post_merge (docs/MULTI-REPO.md sections 3.3 to 3.6, KAT-86 T4).
+//
+// A dot whose app repos have no Playwright suite keeps its end-to-end suite in a separate repo, the Tests repo (a repo with role test).
+// When a PR of an app repo is checked, or a merge of it is tested, the dot runs that suite after the app repo's own tests, against the
+// same target: the PR's preview when one is known, else the dot's base URL (a PR) and the base URL after the deploy wait (a merge).
+// The batch checks out the Tests repo at a ref chosen by src/runner/test-repo.ts, runs the whole suite or the tests of the changed
+// areas, and hands back a report whose cases name their file `owner/name:path`. mergeReports joins it to the app report.
+//
+// The app repo's Run tests switch decides about the app repo's own suite only. The dot has two switches for this batch, one for PRs
+// and one for merges, both on by default.
+import { addStep, isRunCancelled } from '../agent/runs.js';
+import { githubFor } from '../integrations/github.js';
+import { fullName, targetRepo, watchRepos } from '../repos.js';
+import { refRuleWords, testRepoSentence } from '../review/test-repo-lines.js';
+import { refSourceOf, resolveTestRef, testRepoRefusal } from '../runner/test-repo.js';
+import { runSuite } from './common.js';
+import { mergeReports } from './qa.js';
+export { testRepoSentence };
+// ---------- the dot's switches ----------
+/** The two switches of the dot, with their defaults: both on. */
+export function testRepoSwitches(w) {
+    return { onPr: w.testRepoOnPr !== false, onMerge: w.testRepoOnMerge !== false };
+}
+/** Why the switches of a save are not usable, or null. A switch is true, false, or null (back to the default). */
+export function testRepoSwitchError(v) {
+    for (const k of ['testRepoOnPr', 'testRepoOnMerge']) {
+        if (v[k] !== undefined && v[k] !== null && typeof v[k] !== 'boolean')
+            return `${k} must be true or false.`;
+    }
+    return null;
+}
+/** The sentence the report gives when a switch holds the batch back. */
+function switchReason(task) {
+    return task === 'pr_check' ? 'the dot\'s "Run the Tests repo on app PRs" switch is off' : 'the dot\'s "Run the Tests repo on merges" switch is off';
+}
+// ---------- which Tests repos run ----------
+/**
+ * The Tests repos a PR check or a merge of this event runs: each repo of role test that exercises the app repo of the event (its
+ * `targets`, else every app repo) and takes the job (`test.on`, else both). Not the dot's switch: the caller says why a batch is held back.
+ * An event with no repo belongs to the dot's first app repo.
+ */
+export function testReposFor(watch, ev, task) {
+    const app = targetRepo(watch, ev);
+    if (!app || app.role !== 'app')
+        return [];
+    return watchRepos(watch).filter((r) => r.role === 'test' && (!r.targets?.length || r.targets.includes(app.id)) && (r.test?.on ?? ['pr_check', 'post_merge']).includes(task));
+}
+/** The sentence that says why the batch does not run for this event, or null when it does. */
+export function testRepoHold(o) {
+    const sw = testRepoSwitches(o.watch);
+    if (o.task === 'pr_check' ? !sw.onPr : !sw.onMerge)
+        return switchReason(o.task);
+    if (o.docsOnly)
+        return 'only docs or the changelog changed';
+    if (o.prSkip)
+        return o.prSkip;
+    if (!o.baseUrl && o.watch.runner.mode !== 'demo')
+        return o.task === 'pr_check'
+            ? 'no preview of this PR is known and the dot has no base URL to run them against'
+            : 'the dot has no base URL to run them against';
+    return null;
+}
+const escapeRe = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+const sayList = (xs) => (xs.length <= 2 ? xs.join(' and ') : `${xs.slice(0, -1).join(', ')} and ${xs[xs.length - 1]}`);
+/**
+ * Which tests of the Tests repo run. Narrower than the whole suite only when the repo maps areas to tests (`test.areas`), the review's
+ * regression scope is area or narrow, and every area of the change is mapped: the tests of those areas run, and the quick tests (the
+ * smoke text) with them. Anything else runs the whole suite: no mapping, no review, a wide scope (broad or full), no area named, or an area
+ * with no tests mapped to it, since nobody can say which tests cover that area. A selection that matches no test is caught by the caller.
+ */
+export function selectTestRepoSuite(o) {
+    const whole = (reason) => ({ selection: 'the whole suite', reason: `the whole suite runs: ${reason}` });
+    const mapped = new Map(Object.entries(o.config?.areas ?? {}).map(([area, grep]) => [area.trim().toLowerCase(), grep]));
+    if (!mapped.size)
+        return whole('no area is mapped to tests');
+    const review = o.review;
+    if (!review)
+        return whole('there is no review of the change to pick tests from');
+    const level = review.regressionScope.level;
+    if (level === 'full' || level === 'broad')
+        return whole(`the review's regression scope is ${level}`);
+    const ids = review.regressionScope.areaIds;
+    const areas = ids.length ? review.impactAreas.filter((a) => ids.includes(a.id)) : review.impactAreas;
+    if (!areas.length)
+        return whole('the review names no area of the change');
+    const names = [...new Set(areas.map((a) => a.area.trim()).filter(Boolean))];
+    const missing = names.filter((n) => !mapped.has(n.toLowerCase()));
+    if (!names.length || missing.length)
+        return whole(`no tests are mapped to ${sayList(missing.length ? missing : ['the changed area'])}`);
+    const smoke = o.config?.smokeGrep?.trim() || '@smoke';
+    const parts = [...new Set(names.map((n) => mapped.get(n.toLowerCase()))), escapeRe(smoke)];
+    return {
+        grep: parts.map((p) => `(?:${p})`).join('|'),
+        selection: `the tests of ${sayList(names)}, and the quick tests`,
+        reason: `the tests mapped to ${sayList(names)} run, with the quick tests (${review.regressionScope.level} scope)`,
+    };
+}
+// ---------- joining the batch to the app report ----------
+/**
+ * The report of the app repo's own tests joined with the report of a Tests repo batch. A batch that ran nothing (it was skipped) only adds
+ * its line. A batch that ran replaces an app report that was itself skipped, so a repo with Run tests off still shows the result of its
+ * Tests repo; otherwise the two are merged, and a batch that did not run marks the merged report like any other batch (mergeReports).
+ */
+export function joinTestRepoReport(app, batch) {
+    const testRepos = [...(app.testRepos ?? []), ...(batch.testRepos ?? [])];
+    if (!batch.cases.length && !batch.notRun)
+        return { ...app, ...(testRepos.length ? { testRepos } : {}) };
+    if (app.notRun?.stage === 'skipped' && !app.cases.length)
+        return { ...batch, testRepos };
+    return mergeReports(app, batch);
+}
+const sha7 = (sha) => sha.slice(0, 7);
+/**
+ * Runs the Tests repos of the event one after the other and joins their reports. Never throws except when GitHub cannot be reached, which
+ * the job retries. A repo that cannot be checked out or run gives a report that did not run, with its reason on its line.
+ */
+export async function runTestRepos(i) {
+    let joined;
+    const flaky = [];
+    for (const repo of i.repos) {
+        if (isRunCancelled(i.runId))
+            break;
+        const one = await runOne(i, repo);
+        flaky.push(...one.flaky);
+        joined = joined ? joinTestRepoReport(joined, one.report) : one.report;
+    }
+    return joined ? { report: joined, flaky } : null;
+}
+async function runOne(i, repo) {
+    const { watch, ev, runId, task } = i;
+    const name = fullName(repo);
+    const cfg = repo.test ?? { framework: 'playwright' };
+    const label = cfg.label?.trim() || undefined;
+    const started = Date.now();
+    const stub = (run, notRun) => ({
+        mode: watch.runner.mode,
+        command: '',
+        startedAt: new Date(started).toISOString(),
+        durationMs: 0,
+        passed: 0,
+        failed: 0,
+        flaky: 0,
+        skipped: 0,
+        cases: [],
+        ...(i.baseUrl ? { baseUrl: i.baseUrl } : {}),
+        ...(notRun ? { notRun } : {}),
+        testRepos: [
+            {
+                repo: repo.id,
+                name: repo.name,
+                ...(label ? { label } : {}),
+                ref: '',
+                refRule: 'default',
+                sha: '',
+                selection: '',
+                passed: 0,
+                failed: 0,
+                flaky: 0,
+                skipped: 0,
+                ...run,
+            },
+        ],
+    });
+    // What must not start: a framework localdost cannot run, a fork PR outside Docker (the fork rule). Nothing failed, so nothing is marked.
+    const fork = !!ev.pr?.fork;
+    const refusal = testRepoRefusal({ repo: { owner: repo.owner, name: repo.name }, ref: '', sha: '', config: cfg, ...(fork ? { fork } : {}) }, watch.runner.mode, watch.runner.passEnv);
+    if (refusal) {
+        addStep(runId, `Tests repo skipped: ${name}`, refusal, 'warn');
+        return { report: stub({ notRun: refusal, notRunOnPurpose: true }), flaky: [] };
+    }
+    const gh = githubFor(watch, { repo: { owner: repo.owner, name: repo.name } });
+    const source = refSourceOf(gh);
+    if (!source) {
+        const reason = 'GitHub is not connected, so the Tests repo cannot be fetched.';
+        addStep(runId, `Tests repo could not be checked out: ${name}`, reason, 'warn');
+        return {
+            report: stub({ notRun: reason }, { stage: 'checkout', reason: `The tests of ${name} did not run: ${reason}`, testRepo: repo.id }),
+            flaky: [],
+        };
+    }
+    const resolved = await resolveTestRef({
+        ...(repo.test ? { config: repo.test } : {}),
+        defaultBranch: repo.defaultBranch,
+        task,
+        prBody: ev.pr?.body,
+        prHeadRef: ev.pr?.headRef,
+        fork,
+        source,
+        repo: { owner: repo.owner, name: repo.name },
+    });
+    if (!resolved.ok) {
+        addStep(runId, `Tests repo could not be checked out: ${name}`, resolved.reason, 'warn');
+        return { report: stub({ notRun: resolved.reason }, { stage: 'checkout', reason: resolved.reason, testRepo: repo.id }), flaky: [] };
+    }
+    const { ref, rule, sha, note } = resolved.ref;
+    addStep(runId, `Tests repo: ${name}`, `Runs ${ref} at ${sha7(sha)} (${refRuleWords(rule)}).${note ? ` ${note}` : ''}`, note ? 'warn' : 'info');
+    let suite = selectTestRepoSuite({ config: cfg, review: i.review });
+    addStep(runId, 'Picked tests of the Tests repo', suite.reason);
+    const testRepo = { repo: { owner: repo.owner, name: repo.name }, ref, sha, config: cfg, ...(fork ? { fork } : {}) };
+    let out = await runSuite(watch, runId, { ...(i.baseUrl ? { baseUrl: i.baseUrl } : {}), ...(suite.grep ? { grep: suite.grep } : {}), testRepo });
+    // A selection that matches no test must not read as a pass: the whole suite runs instead.
+    if (suite.grep && !out.report.notRun && !out.report.cases.length) {
+        addStep(runId, 'No test matched the changed areas', 'The tests mapped to the changed areas matched nothing, so the whole suite of the Tests repo runs.', 'warn');
+        suite = { selection: 'the whole suite', reason: 'no test matched the changed areas' };
+        out = await runSuite(watch, runId, { ...(i.baseUrl ? { baseUrl: i.baseUrl } : {}), testRepo });
+    }
+    const r = out.report;
+    const run = {
+        repo: repo.id,
+        name: repo.name,
+        ...(label ? { label } : {}),
+        ref,
+        refRule: rule,
+        sha,
+        ...(note ? { note } : {}),
+        selection: suite.selection,
+        ...(i.baseUrl ? { baseUrl: i.baseUrl } : {}),
+        passed: r.passed,
+        failed: r.failed,
+        flaky: r.flaky,
+        skipped: r.skipped,
+        ...(r.notRun ? { notRun: r.notRun.reason } : {}),
+    };
+    // The report says which batch did not run, so a verdict that reads the merged report blames the right repo.
+    const notRun = r.notRun ? { ...r.notRun, testRepo: repo.id } : undefined;
+    return { report: { ...r, ...(notRun ? { notRun } : {}), testRepos: [run] }, flaky: out.flaky };
+}
+//# sourceMappingURL=testRepo.js.map

package/dist/flows/testRepo.js.map

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

package/dist/flows/testSavings.js

@@ -0,0 +1,381 @@
+// Fewer test runs (KAT-344). Three rules keep the dot from running the suite when it learns nothing new:
+//   1. A change of only docs, the changelog, or the version field of package.json skips the test run.
+//   2. A pr_check job waits for a quiet period, and a newer head of the same PR replaces the older job.
+//   3. post_merge reuses the passing PR results when the merge commit has the same tree as the PR head.
+// Each rule has a per-dot switch (testDocsOnlySkip, testDebounceSec, reuseMergeResults), all on by default.
+import { spawnSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { list, update } from '../db.js';
+import { addStep, cancelRun } from '../agent/runs.js';
+import { cancelRunProcess } from '../runner/index.js';
+import { engineOf } from '../runner/pwgen/index.js';
+import { log } from '../config.js';
+import { FORK_NOT_RUN_LINE } from '../review/render.js';
+import { isTestRepoFile } from '../review/test-repo-file.js';
+export const DEFAULT_DEBOUNCE_SEC = 120;
+/** The quiet period of a dot that sets none. A process-wide override exists so the test scripts can start queued PR jobs at once. */
+function defaultDebounceSec() {
+    const raw = process.env.LOCALDOST_TEST_DEBOUNCE_DEFAULT_SEC;
+    const n = Number(raw);
+    return raw !== undefined && Number.isInteger(n) && n >= 0 ? n : DEFAULT_DEBOUNCE_SEC;
+}
+export const MAX_DEBOUNCE_SEC = 3600;
+/** The dot's switches with the defaults: both skips on, a 120 s quiet period. */
+export function testSavings(watch) {
+    return {
+        docsOnlySkip: watch.testDocsOnlySkip ?? true,
+        debounceSec: typeof watch.testDebounceSec === 'number' ? watch.testDebounceSec : defaultDebounceSec(),
+        reuseMergeResults: watch.reuseMergeResults ?? true,
+    };
+}
+/** Why a dot's test-saving fields are not usable, or null. Used by the dot create and update routes. */
+export function testSavingsError(v) {
+    for (const k of ['testDocsOnlySkip', 'reuseMergeResults']) {
+        if (v[k] !== undefined && typeof v[k] !== 'boolean')
+            return `${k} must be true or false.`;
+    }
+    const d = v.testDebounceSec;
+    if (d !== undefined && !(typeof d === 'number' && Number.isInteger(d) && d >= 0 && d <= MAX_DEBOUNCE_SEC))
+        return `testDebounceSec must be a whole number of seconds from 0 to ${MAX_DEBOUNCE_SEC}. 0 turns the quiet period off.`;
+    return null;
+}
+// ---------- 1. docs-only changes ----------
+const VERSION_LINE_RE = /^\s*"version"\s*:\s*"[^"]*"\s*,?\s*$/;
+/** True when the patch changes nothing but "version" lines. A missing patch (too large for GitHub) is never version-only. */
+export function versionOnlyPatch(patch, maxChanged = Infinity) {
+    if (!patch)
+        return false;
+    let changed = 0;
+    for (const line of patch.split('\n')) {
+        if (line.startsWith('+++') || line.startsWith('---') || line.startsWith('@@'))
+            continue;
+        if (!line.startsWith('+') && !line.startsWith('-'))
+            continue;
+        if (!VERSION_LINE_RE.test(line.slice(1)))
+            return false;
+        changed++;
+    }
+    return changed > 0 && changed <= maxChanged;
+}
+/** The old and new value of the one version line a package.json patch changes, or null. */
+function versionPair(patch) {
+    const val = (sign) => patch
+        ?.split('\n')
+        .find((l) => l.startsWith(sign) && !l.startsWith(sign + sign + sign))
+        ?.match(/"version"\s*:\s*"([^"]+)"/)?.[1];
+    const from = val('-');
+    const to = val('+');
+    return from && to ? { from, to } : null;
+}
+/** True when every changed version line of a lockfile patch moves from the project's old version to its new one. */
+function sameBump(patch, bump) {
+    for (const line of (patch ?? '').split('\n')) {
+        if (line.startsWith('+++') || line.startsWith('---'))
+            continue;
+        const v = line.match(/"version"\s*:\s*"([^"]+)"/)?.[1];
+        if (line.startsWith('-') && v !== bump.from)
+            return false;
+        if (line.startsWith('+') && v !== bump.to)
+            return false;
+    }
+    return true;
+}
+/**
+ * True when every changed version line of a lockfile patch is one of the project's own: the top-level field (two-space
+ * indent), or the version under the `packages[""]` entry within the hunk's context lines. A nested dependency entry
+ * (`"node_modules/x": {`, even an aliased one with its own `"name"`) is installed code, whatever version it moves to.
+ */
+function rootVersionLines(patch) {
+    const lines = (patch ?? '').split('\n');
+    return lines.every((line, i) => {
+        if (!/^[-+]\s*"version"\s*:/.test(line) || line.startsWith('+++') || line.startsWith('---'))
+            return true;
+        if (/^[-+] {2}"version"/.test(line))
+            return true;
+        for (let j = i - 1; j >= 0 && j >= i - 4; j--) {
+            const ctx = lines[j];
+            if (ctx.startsWith('@@'))
+                break;
+            if (ctx.startsWith('-') || ctx.startsWith('+'))
+                continue;
+            if (/^\s*"":\s*\{/.test(ctx.slice(1)))
+                return true;
+            if (/^\s*"[^"]+":\s*\{/.test(ctx.slice(1)))
+                return false;
+        }
+        return false;
+    });
+}
+function isDocsPath(path) {
+    const p = path.replace(/^\.?\//, '');
+    return /\.md$/i.test(p) || p.startsWith('docs/');
+}
+/**
+ * True when every changed file is docs (*.md, docs/**), the changelog, or the version field of package.json or
+ * package-lock.json. An empty file list is not docs-only: nothing is known about the change, so the tests run.
+ */
+export function docsOnlyChange(files) {
+    if (!files.length)
+        return false;
+    // A lockfile counts as a version bump only next to the project's own bump in package.json, and only for its two
+    // root version lines (each one removed and one added): a nested dependency version is installed code.
+    const manifest = files.find((f) => /(?:^|\/)package\.json$/.test(f.path) && f.status === 'modified' && versionOnlyPatch(f.patch, 2));
+    const bump = manifest ? versionPair(manifest.patch) : null;
+    return files.every((f) => {
+        if (f.status === 'removed' && !isDocsPath(f.path))
+            return false;
+        if (isDocsPath(f.path))
+            return true;
+        if (/(?:^|\/)package\.json$/.test(f.path))
+            return f.status === 'modified' && versionOnlyPatch(f.patch, 2);
+        if (/(?:^|\/)package-lock\.json$/.test(f.path))
+            return !!bump && f.status === 'modified' && versionOnlyPatch(f.patch, 4) && sameBump(f.patch, bump) && rootVersionLines(f.patch);
+        return false;
+    });
+}
+/** The report of a run that skipped its tests. Not a failure: stage `skipped`. */
+export function skippedReport(reason, now = new Date()) {
+    return {
+        mode: 'local',
+        command: '',
+        startedAt: now.toISOString(),
+        durationMs: 0,
+        passed: 0,
+        failed: 0,
+        flaky: 0,
+        skipped: 0,
+        cases: [],
+        notRun: { stage: 'skipped', reason },
+    };
+}
+/** Why a fork pull request got no test run, for the run step and the verdict. The PR comment shows FORK_NOT_RUN_LINE. */
+export const FORK_NOT_RUN_REASON = 'This PR comes from a fork, so localdost did not run its code. The code review still ran.';
+/**
+ * The report of a fork pull request that was reviewed and not tested (KAT-384). Unlike a skip on purpose it is no pass:
+ * no test ran for the commit, so the stage is `checkout` and the CI note and the "not tested yet" wording apply.
+ */
+export function forkNotRunReport(now = new Date()) {
+    return { ...skippedReport(FORK_NOT_RUN_LINE, now), notRun: { stage: 'checkout', reason: FORK_NOT_RUN_REASON, fork: true } };
+}
+function hasPr(ev) {
+    return !!ev?.pr?.number;
+}
+const repoKey = (ev) => (ev.repo ? `${ev.repo.owner}/${ev.repo.name}`.toLowerCase() : '');
+/** When a new pr_check job may start: after the dot's quiet period. Undefined means now. Requested reviews never wait. */
+export function debouncedRunAfter(watch, ev, now = Date.now()) {
+    const sec = testSavings(watch).debounceSec;
+    if (sec <= 0 || !hasPr(ev) || ev.requestedBy)
+        return undefined;
+    return new Date(now + sec * 1000).toISOString();
+}
+// ---------- current head of each PR (KAT-346) ----------
+// `ties`: other heads delivered with the same updated_at. Nothing orders them, so none of them is stale and none stops another.
+const currentHeads = new Map();
+const headKey = (repo, pr) => `${repo.toLowerCase()}#${pr}`;
+const sameHead = (a, b) => !!a && !!b && (a.startsWith(b) || b.startsWith(a));
+/**
+ * Records the head a pull_request delivery names, unless a delivery with a later updated_at already named another one.
+ * `updatedAt` is the PR's own updated_at (ISO); a delivery without it counts as newest by arrival.
+ */
+export function notePrHead(repo, pr, headSha, updatedAt) {
+    if (!repo || !headSha)
+        return;
+    const t = updatedAt ? Date.parse(updatedAt) : NaN;
+    const at = Number.isFinite(t) ? t : Date.now();
+    const key = headKey(repo, pr);
+    const cur = currentHeads.get(key);
+    if (cur && at < cur.at && !sameHead(cur.sha, headSha))
+        return;
+    if (cur && at === cur.at && !sameHead(cur.sha, headSha)) {
+        if (!cur.ties?.some((t) => sameHead(t, headSha)))
+            cur.ties = [...(cur.ties ?? []), headSha];
+        return;
+    }
+    // A redelivery of the same head never moves its time back, or an older head could then pass it.
+    const same = !!cur && sameHead(cur.sha, headSha);
+    currentHeads.set(key, { sha: headSha, at: same ? Math.max(cur.at, at) : at, ...(same && at <= cur.at && cur.ties ? { ties: cur.ties } : {}) });
+}
+/** True when the dot knows a different current head for this PR: the event came late and must start nothing and cancel nothing. */
+export function isStalePrHead(ev) {
+    if (!hasPr(ev) || !ev.pr.headSha || !ev.repo)
+        return false;
+    const cur = currentHeads.get(headKey(repoKey(ev), ev.pr.number));
+    return !!cur && !sameHead(cur.sha, ev.pr.headSha) && !cur.ties?.some((t) => sameHead(t, ev.pr.headSha));
+}
+/** True when another head of this PR has the same updated_at as the current one: neither may stop the other's jobs. */
+export function isTiedPrHead(ev) {
+    if (!hasPr(ev) || !ev.repo)
+        return false;
+    return !!currentHeads.get(headKey(repoKey(ev), ev.pr.number))?.ties?.length;
+}
+/** Forgets every tracked head. Used by tests. */
+export function resetPrHeads() {
+    currentHeads.clear();
+}
+/**
+ * A newer head of a PR arrived: older pr_check jobs of the same PR in the same repo stop. A queued job is dropped
+ * (marked done, with a note that names the newer head). A running run gets a step and goes through the cancel path
+ * of POST /api/runs/:id/cancel: the run is marked cancelled and its test process is killed.
+ */
+export function supersedeOlderPrJobs(newJobId, watch, ev) {
+    const out = { dropped: [], cancelled: [] };
+    if (testSavings(watch).debounceSec <= 0 || !hasPr(ev) || ev.requestedBy || !ev.pr.headSha)
+        return out;
+    const head = ev.pr.headSha;
+    const short = head.slice(0, 7);
+    // KAT-346: only the current head of the PR may stop older jobs; a late delivery for an old head stops nothing.
+    if (isTiedPrHead(ev)) {
+        log.info(`PR #${ev.pr.number}: head ${short} has the same updated_at as another head and supersedes nothing`);
+        return out;
+    }
+    if (isStalePrHead(ev)) {
+        log.info(`PR #${ev.pr.number}: stale head ${short} supersedes nothing`);
+        return out;
+    }
+    const note = `Superseded by newer head ${short} of PR #${ev.pr.number}.`;
+    for (const j of list('jobs', { watchId: watch.id, kind: 'pr_check', status: ['queued', 'running'] })) {
+        if (j.id === newJobId)
+            continue;
+        const old = j.payload;
+        if (!hasPr(old) || old.requestedBy || old.pr.number !== ev.pr.number || repoKey(old) !== repoKey(ev))
+            continue;
+        if (!old.pr.headSha || old.pr.headSha === head)
+            continue;
+        if (j.status === 'queued') {
+            update('jobs', j.id, { status: 'done', error: note, finishedAt: new Date().toISOString() });
+            out.dropped.push(j.id);
+            continue;
+        }
+        for (const r of list('runs', { watchId: watch.id, status: 'running' }).filter((x) => x.jobId === j.id)) {
+            addStep(r.id, `Superseded by newer head ${short}`, `PR #${ev.pr.number} has a newer head, so this run for ${old.pr.headSha.slice(0, 7)} stops.`, 'warn');
+            if (cancelRun(r.id, `a newer head ${short}`)) {
+                cancelRunProcess(r.id);
+                out.cancelled.push(r.id);
+            }
+        }
+    }
+    if (out.dropped.length || out.cancelled.length)
+        log.info(`PR #${ev.pr.number}: head ${short} superseded ${out.dropped.length} queued job(s) and ${out.cancelled.length} running run(s)`);
+    return out;
+}
+// ---------- 3. post_merge reuses the PR results ----------
+/** The tree of a commit: the working folder's git first (git rev-parse), then the GitHub commit. Null when neither knows it. */
+export async function treeOf(watch, gh, sha) {
+    const dir = watch.runner?.workdir;
+    if (dir && existsSync(dir) && /^[0-9a-f]{7,64}$/i.test(sha)) {
+        const r = spawnSync('git', ['-C', dir, 'rev-parse', '--verify', '--quiet', `${sha}^{tree}`], { encoding: 'utf8', timeout: 15_000 });
+        const out = (r.stdout ?? '').trim();
+        if (r.status === 0 && /^[0-9a-f]{40,64}$/.test(out))
+            return out;
+    }
+    try {
+        return (await gh.getCommit(sha))?.treeSha ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Tests that ran: skipped tests did not. */
+const ran = (r) => r.passed + r.failed + r.flaky;
+/**
+ * The PR a merge belongs to: the PR of a pr_merged event, else the number a squash or merge commit puts in its title
+ * ("... (#120)", "Merge pull request #120 ..."). A push to main carries no PR of its own.
+ */
+export function mergedPrNumber(ev) {
+    if (ev.pr?.number)
+        return ev.pr.number;
+    if (!ev.push)
+        return null;
+    const first = ev.title.replace(/^Push to [^:]+:\s*/, '').split('\n')[0] ?? '';
+    const m = /\(#(\d+)\)\s*$/.exec(first) ?? /^Merge pull request #(\d+)\b/.exec(first);
+    return m ? Number(m[1]) : null;
+}
+/** The commit a post_merge run tests. */
+export function mergeShaOf(ev) {
+    return ev.pr?.mergeSha || ev.push?.after || '';
+}
+/** The latest pr_check run of this PR that ran tests, when those tests passed. Otherwise null. */
+export function lastPassedPrRun(watchId, prNumber, repo) {
+    const runs = list('runs', { watchId, kind: 'pr_check' }, { orderBy: 'createdAt DESC', limit: 300 }).filter((r) => r.status === 'done' && r.trigger?.pr?.number === prNumber && (r.trigger.repo ? repoKey(r.trigger) : '') === repo);
+    // KAT-345: reuse needs tests that ran and passed. Skipped tests (docs-only rule or any other) never count as a pass.
+    const tested = runs.find((r) => r.report && !r.report.notRun && !r.report.interrupted && ran(r.report) > 0);
+    return tested &&
+        tested.report.passed > 0 &&
+        tested.report.failed === 0 &&
+        tested.report.flaky === 0 &&
+        tested.verdict?.outcome !== 'product_failure' &&
+        tested.verdict?.outcome !== 'test_failure'
+        ? tested
+        : null;
+}
+/** JSON with object keys sorted at every level, so the same settings always give the same string. */
+function stableJson(v) {
+    if (Array.isArray(v))
+        return `[${v.map(stableJson).join(',')}]`;
+    if (v && typeof v === 'object')
+        return `{${Object.keys(v)
+            .filter((k) => v[k] !== undefined)
+            .sort()
+            .map((k) => `${JSON.stringify(k)}:${stableJson(v[k])}`)
+            .join(',')}}`;
+    return JSON.stringify(v ?? null);
+}
+/**
+ * The dot settings that decide what a test run runs: every runner setting, the engine as resolved (so a new workspace
+ * default counts), and the base URL. A merge reuses PR results only when this is unchanged, so any runner change runs
+ * the merge's own tests.
+ */
+export function runnerKey(watch) {
+    return stableJson({ runner: watch.runner, engine: engineOf(watch), baseUrl: watch.baseUrl ?? '' });
+}
+/** True when the PR run's recorded specs cover the merge's selection. A run without testedSpecs ran an unknown set and covers nothing. */
+export function prRunCovers(run, merge) {
+    const tested = run.testedSpecs;
+    if (!tested)
+        return false;
+    // A PR preview is another environment than the merge's target: results there say nothing about it.
+    if ((tested.baseUrl ?? '') !== (merge.baseUrl ?? ''))
+        return false;
+    if (tested.full)
+        return true;
+    return !merge.full && merge.specs.every((s) => tested.specs.includes(s));
+}
+/**
+ * The spec suite results of a PR report. Generated (pwgen/) and AI-Vision (aivision/) cases follow their own post_merge
+ * options and run on the merge itself, so a reused report leaves them out. So do the cases of a Tests repo: its batch runs on
+ * the merge too, against the build the merge deployed, and the PR's results of it say nothing about that build (KAT-86).
+ */
+export function specSuiteReport(r) {
+    const cases = r.cases.filter((c) => !c.file.startsWith('pwgen/') && !c.file.startsWith('aivision/') && !isTestRepoFile(c.file));
+    if (cases.length === r.cases.length && !r.generated && !r.testRepos)
+        return { ...r };
+    const out = {
+        ...r,
+        cases,
+        passed: cases.filter((c) => c.status === 'passed').length,
+        failed: cases.filter((c) => c.status === 'failed' || c.status === 'timedOut').length,
+        flaky: cases.filter((c) => c.status === 'flaky').length,
+        skipped: cases.filter((c) => c.status === 'skipped').length,
+    };
+    delete out.generated;
+    delete out.testRepos;
+    return out;
+}
+/** The PR run whose results the merge may reuse: the merge commit has the same tree as the head that run tested, and the run ran every spec the merge would. */
+export async function reusableMergeRun(watch, gh, ev, selection) {
+    const num = mergedPrNumber(ev);
+    const mergeSha = mergeShaOf(ev);
+    if (!num || !mergeSha)
+        return null;
+    const run = lastPassedPrRun(watch.id, num, repoKey(ev));
+    const head = run?.trigger?.pr?.headSha;
+    // A run from before runnerKey, or one tested with other runner settings, ran something else: the merge runs its own tests.
+    if (!run || !head || run.runnerKey !== runnerKey(watch))
+        return null;
+    // A PR run that ran a subset of the suite says nothing about the specs the merge would add.
+    if (!prRunCovers(run, selection))
+        return null;
+    const [a, b] = await Promise.all([treeOf(watch, gh, head), treeOf(watch, gh, mergeSha)]);
+    return a && b && a === b ? { run, head, tree: a } : null;
+}
+//# sourceMappingURL=testSavings.js.map