tinybeeai 0.0.0-stage → 0.16.1

package/dist/flows/qa.js

@@ -0,0 +1,363 @@
+// PR review for QA inside the change flows (docs/PR-REVIEW-QA.md sections 2.10, 3.2, 6.1):
+// review options, spec selection union and order, test results onto whatToTest, verdict
+// mapping, stale bookkeeping per head sha, manual ticks, and post-merge reuse.
+import { list, update } from '../db.js';
+import { setVerdict } from '../agent/runs.js';
+import { buildChangeSummary } from '../review/change-summary.js';
+import { checklistId } from '../review/render.js';
+import { applyCiResults, sameFile } from './ci.js';
+import { hasAppRepo } from '../repos.js';
+const SEV = { low: 0, medium: 1, high: 2, critical: 3 };
+const LEVEL = { narrow: 0, area: 1, broad: 2, full: 3 };
+/** Watch review options with the section 3.1 defaults: on when the watch has a repo. */
+export function reviewSettings(watch) {
+    const r = watch.review;
+    return {
+        enabled: r?.enabled ?? hasAppRepo(watch),
+        verify: r?.verify ?? true,
+        showFrom: r?.showFrom ?? 'medium',
+        blockOn: r?.blockOn ?? null,
+    };
+}
+function inSet(all) {
+    const exact = new Set(all);
+    return (p) => {
+        if (exact.has(p))
+            return p;
+        return all.find((s) => s.endsWith(`/${p}`) || p.endsWith(`/${s}`)) ?? null;
+    };
+}
+function escapeRe(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/** Specs linked to the review's areas, by id first and by area name second. */
+function areaSpecs(review, inv, areaIds) {
+    const out = [];
+    for (const id of areaIds) {
+        out.push(...(inv.byArea[id] ?? []));
+        const name = review.impactAreas.find((a) => a.id === id)?.area;
+        if (name)
+            out.push(...(inv.byArea[name] ?? []));
+    }
+    return out;
+}
+/**
+ * Union of the heuristic pick, verified review tests, tests at risk, area-linked specs (scope
+ * area or wider) and the whole suite (scope full). Order: tests at risk, review tests, rest.
+ */
+export function selectQaSpecs(x) {
+    const known = inSet(x.inv.all);
+    const level = x.review.regressionScope.level;
+    const atRisk = x.review.testsAtRisk
+        .filter((k) => k.verifier.status !== 'refuted')
+        .map((k) => known(k.path))
+        .filter((p) => !!p);
+    // Unverified items count: nobody refuted them, and a dot with verify off still runs its tests.
+    const reviewTests = x.review.whatToTest.filter((t) => t.existingTest && t.verifier.status !== 'refuted');
+    const fromReview = reviewTests.map((t) => known(t.existingTest)).filter((p) => !!p);
+    const linked = LEVEL[level] >= LEVEL.area ? areaSpecs(x.review, x.inv, x.review.regressionScope.areaIds).map(known) : [];
+    const heuristicFull = x.heuristic.length === 0;
+    const full = level === 'full' || heuristicFull;
+    const ordered = [...new Set([...atRisk, ...fromReview, ...x.heuristic, ...linked.filter((p) => !!p)])];
+    const ran = new Set(x.heuristic);
+    let added = heuristicFull ? [] : ordered.filter((p) => !ran.has(p));
+    if (level === 'full' && !heuristicFull)
+        added = [...added, ...x.inv.all.filter((p) => !ran.has(p) && !added.includes(p))];
+    let grep;
+    if (added.length) {
+        const titles = new Map();
+        for (const t of reviewTests) {
+            const p = known(t.existingTest);
+            if (p && t.existingTitle)
+                titles.set(p, [...(titles.get(p) ?? []), t.existingTitle]);
+        }
+        const atRiskSet = new Set(atRisk);
+        if (added.every((p) => titles.has(p) && !atRiskSet.has(p)))
+            grep = [...new Set(added.flatMap((p) => titles.get(p)))].map(escapeRe).join('|');
+    }
+    const parts = [];
+    if (atRisk.length)
+        parts.push(`${atRisk.length} test${atRisk.length === 1 ? '' : 's'} at risk`);
+    if (fromReview.length)
+        parts.push(`${fromReview.length} from what to test`);
+    if (linked.length)
+        parts.push(`${linked.length} linked to ${level} scope`);
+    if (level === 'full')
+        parts.push('full suite for full scope');
+    return {
+        specs: full ? [] : ordered,
+        added,
+        grep,
+        full,
+        reason: parts.length ? parts.join(' + ') : 'the review added no specs',
+    };
+}
+/**
+ * Post-merge: the regression scope drives the run (section 2.10). full runs the whole suite,
+ * broad runs smoke plus every reached spec, area runs reached specs plus smoke, narrow runs
+ * touched specs plus smoke. Tests at risk and review tests always join.
+ */
+export function scopeSpecs(review, inv, changedPaths) {
+    const level = review.regressionScope.level;
+    if (level === 'full')
+        return { specs: [], full: true, reason: `full scope: ${review.regressionScope.reason}` };
+    const known = inSet(inv.all);
+    const atRisk = review.testsAtRisk.filter((k) => k.verifier.status !== 'refuted').map((k) => known(k.path));
+    const fromReview = review.whatToTest.filter((t) => t.existingTest && t.verifier.status !== 'refuted').map((t) => known(t.existingTest));
+    let reached;
+    if (level === 'broad')
+        reached = Object.values(inv.byArea).flat().map(known);
+    else if (level === 'area')
+        reached = areaSpecs(review, inv, review.regressionScope.areaIds).map(known);
+    else
+        reached = changedPaths.map(known);
+    const specs = [...new Set([...atRisk, ...fromReview, ...reached, ...inv.smoke].filter((p) => !!p))];
+    return { specs, full: false, reason: `${level} scope: ${specs.length} spec${specs.length === 1 ? '' : 's'} (${review.regressionScope.reason})` };
+}
+// ---------- results ----------
+const FAILED = (c) => c.status === 'failed' || c.status === 'timedOut';
+export function mergeReports(a, b) {
+    const cases = [...a.cases];
+    for (const c of b.cases) {
+        const i = cases.findIndex((x) => x.title === c.title && x.file === c.file);
+        if (i >= 0)
+            cases[i] = c;
+        else
+            cases.push(c);
+    }
+    const out = {
+        ...a,
+        cases,
+        passed: cases.filter((c) => c.status === 'passed').length,
+        failed: cases.filter(FAILED).length,
+        flaky: cases.filter((c) => c.status === 'flaky').length,
+        skipped: cases.filter((c) => c.status === 'skipped').length,
+        durationMs: a.durationMs + b.durationMs,
+        interrupted: a.interrupted || b.interrupted,
+    };
+    const generated = [...(a.generated ?? []), ...(b.generated ?? [])];
+    if (generated.length)
+        out.generated = generated;
+    const testRepos = [...(a.testRepos ?? []), ...(b.testRepos ?? [])];
+    if (testRepos.length)
+        out.testRepos = testRepos;
+    // A batch that did not run marks the merged report even when another batch has results, so
+    // AI-Vision cases cannot hide a Playwright setup failure. The flows still send real failures to
+    // the model (see change.ts), so a not-run batch never hides a failed test either.
+    const notRun = a.notRun ?? b.notRun;
+    if (notRun)
+        out.notRun = notRun;
+    else
+        delete out.notRun;
+    const hint = a.hint ?? b.hint;
+    if (hint)
+        out.hint = hint;
+    const hintFiles = a.hintFiles ?? b.hintFiles;
+    if (hintFiles)
+        out.hintFiles = hintFiles;
+    return out;
+}
+/**
+ * Each whatToTest item with an existingTest gets its result from the matched cases, or not_run. An
+ * item the dot's own run left not run is then settled from the PR's CI job logs when `ci` has them
+ * (resultSource 'ci'); a CI job that is still queued or running settles nothing.
+ */
+export function applyTestResults(review, report, ci) {
+    if (!report && !ci)
+        return review;
+    const whatToTest = review.whatToTest.map((t) => {
+        if (!report || !t.existingTest)
+            return t;
+        if (t.resultSource === 'manual' && t.result === 'passed')
+            return t;
+        const cases = report.cases.filter((c) => sameFile(c.file, t.existingTest) && (!t.existingTitle || c.title.includes(t.existingTitle)));
+        let result = 'not_run';
+        if (cases.some(FAILED))
+            result = 'failed';
+        else if (cases.some((c) => c.status === 'flaky'))
+            result = 'flaky';
+        else if (cases.length && cases.every((c) => c.status === 'skipped'))
+            result = 'skipped';
+        else if (cases.some((c) => c.status === 'passed'))
+            result = 'passed';
+        return { ...t, result, resultSource: 'runner', ...(cases.length ? { coveredBy: ['spec'] } : {}) };
+    });
+    return applyCiResults({ ...review, whatToTest }, ci ?? null);
+}
+/**
+ * Drops runner results a reused review carries from an earlier run (post_merge reuses the PR
+ * review), so this run's engines start clean. Manual results stay.
+ */
+export function clearRunnerResults(review) {
+    const whatToTest = review.whatToTest.map((t) => {
+        if (t.resultSource !== 'runner')
+            return t;
+        const { result: _r, resultSource: _s, coveredBy: _c, ...rest } = t;
+        return rest;
+    });
+    return { ...review, whatToTest };
+}
+/** Ticked checklist ids become manual passes on items the runner did not settle. */
+export function applyManualTicks(review, ticked) {
+    if (!ticked.size)
+        return review;
+    const whatToTest = review.whatToTest.map((t) => {
+        if (!ticked.has(checklistId(t)))
+            return t;
+        if ((t.resultSource === 'runner' || t.resultSource === 'ci') && t.result && t.result !== 'not_run')
+            return t;
+        return { ...t, result: 'passed', resultSource: 'manual' };
+    });
+    return { ...review, whatToTest };
+}
+// ---------- verdict mapping (section 3.2) ----------
+const MAP_SEV = (s) => (s === 'critical' || s === 'high' ? 'high' : s);
+const RISK_RANK = { low: 0, medium: 1, high: 2 };
+function passingTest(review, r) {
+    return review.whatToTest.some((t) => t.riskIds.includes(r.id) && t.result === 'passed');
+}
+/** Fills Verdict fields from the review when no test failed; always attaches verdict.qa. */
+export function applyQaToVerdict(verdict, review, report, showFrom) {
+    const failed = (report?.failed ?? 0) > 0 || ['product_failure', 'test_failure', 'environment_failure'].includes(verdict.outcome);
+    if (failed)
+        return { ...verdict, qa: review };
+    const shown = review.risks.filter((r) => r.verifier.status !== 'refuted' && SEV[r.severity] >= SEV[showFrom]);
+    const findings = shown.map((r) => ({
+        title: r.title,
+        detail: `${r.why} ${r.userImpact}`.trim(),
+        severity: MAP_SEV(r.severity),
+        ...(r.evidence[0] ? { file: r.evidence[0].file, line: r.evidence[0].line } : {}),
+    }));
+    const titles = new Set(findings.map((f) => f.title.toLowerCase()));
+    const confirmed = review.risks.filter((r) => r.verifier.status === 'confirmed');
+    const qaRisk = confirmed.some((r) => SEV[r.severity] >= SEV.high)
+        ? 'high'
+        : confirmed.some((r) => r.severity === 'medium')
+            ? 'medium'
+            : 'low';
+    const untestedCritical = confirmed.some((r) => r.severity === 'critical' && !passingTest(review, r));
+    return {
+        ...verdict,
+        findings: [...findings, ...verdict.findings.filter((f) => !titles.has(f.title.toLowerCase()))].slice(0, 12),
+        testIdeas: [...new Set([...review.whatToTest.filter((t) => !t.existingTest).map((t) => t.scenario), ...verdict.testIdeas])],
+        testsAtRisk: [...new Set([...review.testsAtRisk.filter((k) => k.verifier.status !== 'refuted').map((k) => k.path), ...verdict.testsAtRisk])],
+        risk: RISK_RANK[qaRisk] > RISK_RANK[verdict.risk] ? qaRisk : verdict.risk,
+        outcome: untestedCritical ? 'needs_attention' : verdict.outcome,
+        qa: review,
+    };
+}
+// ---------- runs: stale heads, ticks, reuse ----------
+function prRuns(watchId, pr) {
+    return list('runs', { watchId, kind: 'pr_check' }, { orderBy: 'createdAt DESC', limit: 200 }).filter((r) => r.trigger?.pr?.number === pr);
+}
+/** Older reviews of this PR at another head get staleFor = the new head. Returns how many. */
+export function markOlderReviewsStale(watchId, pr, head, exceptRunId) {
+    let n = 0;
+    for (const r of prRuns(watchId, pr)) {
+        const qa = r.verdict?.qa;
+        if (r.id === exceptRunId || !qa || qa.staleFor || !qa.head || qa.head === head)
+            continue;
+        setVerdict(r.id, { ...r.verdict, qa: { ...qa, staleFor: head } });
+        n++;
+    }
+    return n;
+}
+/** The head of a pr_check run for this PR that started after `since` at another head, if any. */
+export function newerHead(watchId, pr, head, since) {
+    const newer = prRuns(watchId, pr).find((r) => r.createdAt > since && r.trigger?.pr?.headSha && r.trigger.pr.headSha !== head);
+    return newer?.trigger?.pr?.headSha ?? null;
+}
+/** Checklist ids a person ticked on the latest reviewed run of this PR. */
+export function manualTicks(watchId, pr, exceptRunId) {
+    const run = prRuns(watchId, pr).find((r) => r.id !== exceptRunId && r.verdict?.qa);
+    const out = new Set();
+    for (const t of run?.verdict?.qa?.whatToTest ?? [])
+        if (t.result === 'passed' && t.resultSource === 'manual')
+            out.add(checklistId(t));
+    return out;
+}
+/** Keeps the changed files on the run, so a post-merge review can compare against them. */
+export function storeDiff(runId, diff) {
+    update('runs', runId, { diff: diff.map((f) => ({ ...f, patch: f.patch?.slice(0, 200_000) })) });
+}
+/** A finished pr_check run whose review was made at this head sha. */
+export function findReviewedRun(watchId, head) {
+    if (!head)
+        return undefined;
+    return list('runs', { watchId, kind: 'pr_check' }, { orderBy: 'createdAt DESC', limit: 300 }).find((r) => r.status === 'done' && r.verdict?.qa && r.verdict.qa.head === head && r.verdict.qa.coverage.status === 'complete');
+}
+/** Files of the merge whose patch differs from what the PR review read. */
+export function differingFiles(reviewed, merged) {
+    if (!reviewed)
+        return merged;
+    const before = new Map(reviewed.map((f) => [f.path, f]));
+    return merged.filter((f) => {
+        const old = before.get(f.path);
+        return !old || old.status !== f.status || (old.patch ?? '') !== (f.patch ?? '') || old.additions !== f.additions || old.deletions !== f.deletions;
+    });
+}
+/**
+ * The reused PR review plus a review of the merge difference. Difference items get an "m"
+ * suffix on their ids so both sets stay distinct.
+ */
+export function combineReviews(base, diff, head, files) {
+    const m = (id) => `${id}m`;
+    const areaIds = new Set(diff.impactAreas.map((a) => a.id));
+    const area = (id) => (id && areaIds.has(id) ? m(id) : id);
+    const level = LEVEL[diff.regressionScope.level] > LEVEL[base.regressionScope.level] ? diff.regressionScope : base.regressionScope;
+    const combined = combineParts(base, diff, head, m, area, level);
+    // KAT-144: the change summary covers the whole merge diff, with the areas and risks of both reviews.
+    const merged = files ?? [];
+    combined.changeSummary = merged.length
+        ? buildChangeSummary({
+            files: merged.map((f) => ({ path: f.path, additions: f.additions, deletions: f.deletions })),
+            impactAreas: combined.impactAreas,
+            risks: combined.risks,
+            modelText: base.changeSummary?.source === 'model' ? base.changeSummary.whatItDoes : null,
+            reviewSummary: base.summary,
+        })
+        : undefined;
+    return combined;
+}
+function combineParts(base, diff, head, m, area, level) {
+    return {
+        ...base,
+        head,
+        stats: {
+            files: base.stats.files + diff.stats.files,
+            additions: base.stats.additions + diff.stats.additions,
+            deletions: base.stats.deletions + diff.stats.deletions,
+            changedLines: base.stats.changedLines + diff.stats.changedLines,
+        },
+        impactAreas: [...base.impactAreas, ...diff.impactAreas.map((a) => ({ ...a, id: m(a.id) }))],
+        unmappedFiles: [...new Set([...base.unmappedFiles, ...diff.unmappedFiles])],
+        risks: [...base.risks, ...diff.risks.map((r) => ({ ...r, id: m(r.id), areaId: area(r.areaId), signals: r.signals.map(m) }))],
+        whatToTest: [...base.whatToTest, ...diff.whatToTest.map((t) => ({ ...t, id: m(t.id), areaId: area(t.areaId) ?? t.areaId, riskIds: t.riskIds.map(m) }))],
+        testsAtRisk: [...base.testsAtRisk, ...diff.testsAtRisk.map((k) => ({ ...k, id: m(k.id) }))],
+        testGaps: [...base.testGaps, ...diff.testGaps.map((g) => ({ ...g, id: m(g.id), areaId: area(g.areaId) ?? g.areaId, riskIds: g.riskIds.map(m) }))],
+        regressionScope: { ...level, areaIds: [...new Set([...base.regressionScope.areaIds, ...diff.regressionScope.areaIds.map((id) => m(id))])] },
+        releaseNotesImpact: {
+            ...base.releaseNotesImpact,
+            userVisible: base.releaseNotesImpact.userVisible || diff.releaseNotesImpact.userVisible,
+            breaking: base.releaseNotesImpact.breaking || diff.releaseNotesImpact.breaking,
+            note: base.releaseNotesImpact.note ?? diff.releaseNotesImpact.note,
+        },
+        signals: [...base.signals, ...diff.signals.map((s) => ({ ...s, id: m(s.id) }))],
+        dropped: [...base.dropped, ...diff.dropped.map((d) => ({ ...d, signal: m(d.signal) }))],
+        droppedByVerifier: [...base.droppedByVerifier, ...diff.droppedByVerifier.map((d) => ({ ...d, id: m(d.id) }))],
+        belowFloor: [...base.belowFloor, ...diff.belowFloor.map((b) => ({ ...b, id: m(b.id) }))],
+        belowThreshold: base.belowThreshold + diff.belowThreshold,
+        lenses: [...new Set([...base.lenses, ...diff.lenses])],
+        coverage: {
+            ...diff.coverage,
+            status: base.coverage.status === 'complete' && diff.coverage.status === 'complete' ? 'complete' : 'incomplete',
+            hunks: base.coverage.hunks + diff.coverage.hunks,
+            hunksDelivered: base.coverage.hunksDelivered + diff.coverage.hunksDelivered,
+            undelivered: [...base.coverage.undelivered, ...diff.coverage.undelivered],
+            missing: [...base.coverage.missing, ...diff.coverage.missing],
+        },
+        passes: [...base.passes, ...diff.passes],
+        staleFor: undefined,
+    };
+}
+//# sourceMappingURL=qa.js.map

package/dist/flows/qa.js.map

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

package/dist/flows/questions.js

@@ -0,0 +1,160 @@
+// Questions instead of defects (dogfood ledger: "A defect whose Expected is 'the team decides'"). A finding with no
+// concrete Expected is a design question. The PR comment lists it under "Questions for the team", and when the PR
+// links a Jira or Linear ticket of the dot's tracker, or a GitHub issue (KAT-388), the question is drafted as one ticket
+// comment through the gate (ticket comments ask first by default). Once per ticket and head. The acceptance criteria of
+// a linked ticket that the change does not touch go on the same draft as questions about that ticket.
+import { list } from '../db.js';
+import { gate } from '../agent/rules.js';
+import { addStep } from '../agent/runs.js';
+import { issueRef, parseIssueRef, trackerRepos } from '../integrations/github-issues.js';
+import { linksFor } from '../links.js';
+import { linkedRefs } from '../review/linked-tickets.js';
+import { clipText, inline, questionFor } from '../review/render.js';
+/** The Jira or Linear tickets a PR names, as recorded by recordPrLinks (keys of the dot's own tracker only). */
+export function linkedTickets(watch, ev) {
+    const kind = watch.tracker?.kind;
+    if ((kind !== 'jira' && kind !== 'linear') || !ev.pr || !ev.repo)
+        return [];
+    const pr = issueRef(`${ev.repo.owner}/${ev.repo.name}`, ev.pr.number);
+    const keys = linksFor(pr, watch.id)
+        .filter((l) => l.fromRef === pr.toLowerCase() && l.source === 'ticket_key')
+        .map((l) => l.toRef.toUpperCase());
+    return [...new Set(keys)].sort().slice(0, 3);
+}
+/**
+ * Whether a question may be posted on this GitHub issue: the dot has a GitHub tracker and the issue's repo is one of its
+ * tracker repos. A PR of a Jira or Linear dot that says "Closes #12", or a PR that names an issue of another org, never
+ * gets a comment on that issue, however the Ask rule is set (KAT-388).
+ */
+function mayAskOnGithub(watch, ref) {
+    const gh = parseIssueRef(ref);
+    return !!gh && trackerRepos(watch).includes(gh.full.toLowerCase());
+}
+/**
+ * The tickets a question can be posted on, at most three: the Jira or Linear keys above, then the GitHub issues of the
+ * dot's GitHub tracker that the PR closes or references (keywords, the Development sidebar, "katalon-studio/product#123").
+ * An issue the text only mentions in passing is no link and gets no question.
+ */
+export function questionTargets(watch, ev) {
+    // A fork PR gets no ticket access: its author could name any ticket of the dot's tracker (KAT-388).
+    if (ev.pr?.fork)
+        return [];
+    const kind = watch.tracker?.kind;
+    const tracker = kind === 'jira' || kind === 'linear' ? kind : null;
+    const out = tracker ? linkedTickets(watch, ev).map((key) => ({ tracker, key })) : [];
+    for (const { ref, via } of linkedRefs(watch, ev))
+        if (via !== 'mention' && mayAskOnGithub(watch, ref))
+            out.push({ tracker: 'github', key: ref });
+    return out.slice(0, 3);
+}
+/** What a draft asks about: the finding keys and criterion ids, sorted. The same PR asking the same things is the same question. */
+function askedAbout(bugKeys, criteriaIds) {
+    return [...bugKeys, ...criteriaIds]
+        .map((x) => x.toLowerCase())
+        .sort()
+        .join(',');
+}
+/**
+ * Whether this ticket already got the question. A draft is once per head, and a draft with criteria once per PR and set of
+ * criteria, so a push that changes nothing about them draws no second comment. After a merge the head is the merge sha, so the
+ * PR's own draft would never match: a post_merge draft also counts any earlier draft of the same PR with the same questions.
+ * A PR is its repo plus its number: PR 12 of one repo of a dot and PR 12 of another repo are two PRs (KAT-400).
+ */
+function asked(watchId, target, head, again) {
+    const samePr = (m) => !!again && typeof m?.repo === 'string' && m.repo.toLowerCase() === again.repo.toLowerCase() && m.pr === again.pr && m.about === again.about;
+    const same = (a) => a.kind === 'ticket_comment' && a.target === target && a.meta?.designQuestion === true && (a.meta?.head === head || samePr(a.meta));
+    if (list('approvals', { watchId }, { orderBy: 'createdAt DESC', limit: 300 }).some((a) => same(a.action)))
+        return true;
+    return list('runs', { watchId }, { orderBy: 'createdAt DESC', limit: 100 }).some((r) => r.actions?.some((x) => same(x.action)));
+}
+/** Criteria of one ticket as questions for the team: a criterion no changed line touches is a question, never a bug. */
+function criteriaLines(criteria, key) {
+    return (criteria
+        .filter((c) => c.ticket.toLowerCase() === key.toLowerCase())
+        .slice(0, 6)
+        // The text is tracker text that goes out as a comment: escaped like the PR comment, so an @mention pings nobody.
+        .map((c) => `- "${inline(clipText(c.text, 160))}" Does another PR cover this, or is it left out on purpose?`));
+}
+/**
+ * Drafts one ticket comment per linked ticket with the questions. Returns how many drafts went to the gate. A GitHub issue
+ * gets a plain comment (meta.append), so the sticky review comment of that issue is never replaced. `task` is the run's task:
+ * a post_merge run does not ask again what the PR run already asked.
+ */
+export async function draftTicketQuestions(watch, runId, ev, questions, head, criteria = [], task) {
+    const count = questions.length + criteria.length;
+    if (!count)
+        return 0;
+    const found = questionTargets(watch, ev);
+    // A criterion names its own ticket, so it is asked even when that ticket is not among the first three links.
+    const tickets = [...found];
+    // ...but not when the PR only mentions that ticket: such a link gets no question, so its criteria get none either.
+    const mentioned = new Set(linkedRefs(watch, ev)
+        .filter((l) => l.via === 'mention')
+        .map((l) => l.ref.toLowerCase()));
+    for (const c of ev.pr?.fork ? [] : criteria) {
+        if (mentioned.has(c.ticket.toLowerCase()))
+            continue;
+        const gh = parseIssueRef(c.ticket);
+        const t = gh
+            ? mayAskOnGithub(watch, c.ticket)
+                ? { tracker: 'github', key: issueRef(gh.full, gh.number) }
+                : null
+            : watch.tracker?.kind === 'jira' || watch.tracker?.kind === 'linear'
+                ? { tracker: watch.tracker.kind, key: c.ticket.toUpperCase() }
+                : null;
+        if (t && !tickets.some((x) => x.tracker === t.tracker && x.key.toLowerCase() === t.key.toLowerCase()))
+            tickets.push(t);
+    }
+    if (!tickets.length) {
+        if (questions.length)
+            addStep(runId, 'Questions for the team', `${questions.length} finding${questions.length === 1 ? ' has' : 's have'} no concrete expected result, so the PR comment asks instead of filing a defect.`, 'info');
+        return 0;
+    }
+    let n = 0;
+    for (const { tracker, key } of tickets) {
+        const mine = criteriaLines(criteria, key);
+        // The finding questions go on every linked ticket, as before; a criterion goes only on the ticket it belongs to.
+        if (!questions.length && !mine.length)
+            continue;
+        const target = `${tracker}:${key}`;
+        const mineIds = mine.length ? criteria.filter((c) => c.ticket.toLowerCase() === key.toLowerCase()).map((c) => c.id) : [];
+        const about = askedAbout(questions.map((q) => q.key), mineIds);
+        // Criteria questions are asked once per PR, not once per push: a new head with the same unmet criteria asks nothing new (KAT-388).
+        const again = (task === 'post_merge' || mineIds.length) && ev.pr && ev.repo ? { repo: `${ev.repo.owner}/${ev.repo.name}`, pr: ev.pr.number, about } : undefined;
+        if (asked(watch.id, target, head, again))
+            continue;
+        const asking = questions.length + mine.length;
+        const lead = questions.length || !mine.length
+            ? 'The review could not tell what the right result is, so it asks instead of filing a defect.'
+            : 'The ticket lists acceptance criteria that the change does not touch, so the review asks instead of filing a defect.';
+        const parts = [
+            `localdost has ${asking === 1 ? 'a question' : `${asking} questions`} about PR #${ev.pr.number}${head ? ` at \`${head.slice(0, 7)}\`` : ''}. ${lead}`,
+            '',
+            ...questions.slice(0, 6).map((q) => `- ${questionFor(q)}`),
+            ...mine,
+        ];
+        const gh = tracker === 'github' ? parseIssueRef(key) : null;
+        await gate({
+            kind: 'ticket_comment',
+            target,
+            title: `Question for ${key} from PR #${ev.pr.number}`,
+            body: parts.join('\n'),
+            meta: {
+                tracker,
+                key,
+                designQuestion: true,
+                // A GitHub issue keeps its sticky review comment: the question is a plain comment of its own.
+                ...(gh ? { append: true, issue: gh.number } : {}),
+                head,
+                pr: ev.pr.number,
+                repo: `${ev.repo.owner}/${ev.repo.name}`,
+                bugKeys: questions.map((q) => q.key),
+                about,
+                ...(mine.length ? { criteria: mineIds } : {}),
+            },
+        }, watch, runId);
+        n++;
+    }
+    return n;
+}
+//# sourceMappingURL=questions.js.map

package/dist/flows/questions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"questions.js","sourceRoot":"","sources":["../../src/flows/questions.ts"],"names":[],"mappings":"AAAA,oHAAoH;AACpH,kHAAkH;AAClH,yHAAyH;AACzH,wHAAwH;AACxH,sGAAsG;AAEtG,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACzF,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAY,MAAM,qBAAqB,CAAC;AAG9E,gHAAgH;AAChH,MAAM,UAAU,aAAa,CAAC,KAAY,EAAE,EAAgB;IAC1D,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC;IACjC,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IAC5E,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;IACtE,MAAM,IAAI,GAAG,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,CAAC;SAChC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,EAAE,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,MAAM,KAAK,YAAY,CAAC;SAC1E,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IACrC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC;AAQD;;;;GAIG;AACH,SAAS,cAAc,CAAC,KAAY,EAAE,GAAW;IAC/C,MAAM,EAAE,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IAC9B,OAAO,CAAC,CAAC,EAAE,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;AACrE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAY,EAAE,EAAgB;IAC5D,oGAAoG;IACpG,IAAI,EAAE,CAAC,EAAE,EAAE,IAAI;QAAE,OAAO,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC;IACjC,MAAM,OAAO,GAA6B,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7F,MAAM,GAAG,GAAqB,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACvG,KAAK,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC;QAAE,IAAI,GAAG,KAAK,SAAS,IAAI,cAAc,CAAC,KAAK,EAAE,GAAG,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;IACjJ,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACzB,CAAC;AAED,oIAAoI;AACpI,SAAS,UAAU,CAAC,OAA0B,EAAE,WAA8B;IAC5E,OAAO,CAAC,GAAG,OAAO,EAAE,GAAG,WAAW,CAAC;SAChC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SAC3B,IAAI,EAAE;SACN,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,SAAS,KAAK,CAAC,OAAe,EAAE,MAAc,EAAE,IAAY,EAAE,KAAmD;IAC/G,MAAM,MAAM,GAAG,CAAC,CAA2B,EAAE,EAAE,CAC7C,CAAC,CAAC,KAAK,IAAI,OAAO,CAAC,EAAE,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,CAAC;IAC9I,MAAM,IAAI,GAAG,CAAC,CAAmE,EAAE,EAAE,CACnF,CAAC,CAAC,IAAI,KAAK,gBAAgB,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACrI,IAAI,IAAI,CAAiB,WAAW,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACvI,OAAO,IAAI,CAAY,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAC7I,CAAC;AAED,wHAAwH;AACxH,SAAS,aAAa,CAAC,QAA2B,EAAE,GAAW;IAC7D,OAAO,CACL,QAAQ;SACL,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC,WAAW,EAAE,CAAC;SAC3D,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QACZ,iHAAiH;SAChH,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,6DAA6D,CAAC,CAChH,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAAY,EACZ,KAAa,EACb,EAAgB,EAChB,SAAgB,EAChB,IAAY,EACZ,WAA8B,EAAE,EAChC,IAAa;IAEb,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;IACjD,IAAI,CAAC,KAAK;QAAE,OAAO,CAAC,CAAC;IACrB,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACzC,6GAA6G;IAC7G,MAAM,OAAO,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IAC3B,mHAAmH;IACnH,MAAM,SAAS,GAAG,IAAI,GAAG,CACvB,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC;SAClB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,SAAS,CAAC;SAClC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CACnC,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC5C,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YAAE,SAAS;QACpD,MAAM,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACnC,MAAM,CAAC,GAA0B,EAAE;YACjC,CAAC,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;gBAC/B,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE;gBAC1D,CAAC,CAAC,IAAI;YACR,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,IAAI,KAAK,QAAQ;gBAClE,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE;gBAC9D,CAAC,CAAC,IAAI,CAAC;QACX,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACzH,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,IAAI,SAAS,CAAC,MAAM;YAClB,OAAO,CACL,KAAK,EACL,wBAAwB,EACxB,GAAG,SAAS,CAAC,MAAM,WAAW,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,kFAAkF,EAC1J,MAAM,CACP,CAAC;QACJ,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,OAAO,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC1C,iHAAiH;QACjH,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,SAAS;QAChD,MAAM,MAAM,GAAG,GAAG,OAAO,IAAI,GAAG,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACzH,MAAM,KAAK,GAAG,UAAU,CACtB,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAC3B,OAAO,CACR,CAAC;QACF,mIAAmI;QACnI,MAAM,KAAK,GACT,CAAC,IAAI,KAAK,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACpJ,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC;YAAE,SAAS;QACnD,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC9C,MAAM,IAAI,GACR,SAAS,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM;YAC9B,CAAC,CAAC,4FAA4F;YAC9F,CAAC,CAAC,qHAAqH,CAAC;QAC5H,MAAM,KAAK,GAAG;YACZ,iBAAiB,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,MAAM,YAAY,cAAc,EAAE,CAAC,EAAG,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,EAAE;YACtJ,EAAE;YACF,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1D,GAAG,IAAI;SACR,CAAC;QACF,MAAM,EAAE,GAAG,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC5D,MAAM,IAAI,CACR;YACE,IAAI,EAAE,gBAAgB;YACtB,MAAM;YACN,KAAK,EAAE,gBAAgB,GAAG,aAAa,EAAE,CAAC,EAAG,CAAC,MAAM,EAAE;YACtD,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;YACtB,IAAI,EAAE;gBACJ,OAAO;gBACP,GAAG;gBACH,cAAc,EAAE,IAAI;gBACpB,8FAA8F;gBAC9F,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjD,IAAI;gBACJ,EAAE,EAAE,EAAE,CAAC,EAAG,CAAC,MAAM;gBACjB,IAAI,EAAE,GAAG,EAAE,CAAC,IAAK,CAAC,KAAK,IAAI,EAAE,CAAC,IAAK,CAAC,IAAI,EAAE;gBAC1C,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;gBACpC,KAAK;gBACL,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC9C;SACF,EACD,KAAK,EACL,KAAK,CACN,CAAC;QACF,CAAC,EAAE,CAAC;IACN,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/flows/recovery.js

@@ -0,0 +1,64 @@
+// recovery: the probe passes again after an outage. Close the loop with a calm notice.
+import { gate } from '../agent/rules.js';
+import { addStep, finishRun, setVerdict, startRun } from '../agent/runs.js';
+import { registerHandler } from '../queue.js';
+import { eventOf, guarded, loadWatch, pushAction, recentRuns } from './common.js';
+function host(url) {
+    try {
+        return new URL(url).host;
+    }
+    catch {
+        return url;
+    }
+}
+registerHandler('recovery', async (job) => {
+    const watch = loadWatch(job.watchId);
+    const ev = eventOf(job);
+    const lastOutage = recentRuns(watch.id, 72).find((r) => r.kind === 'outage');
+    const run = startRun(watch.id, 'recovery', ev);
+    await guarded(run.id, async () => {
+        if (ev.selfHealth) {
+            // The dot's own channel or tests work again (src/monitor/self-health.ts).
+            addStep(run.id, 'Self-health check passing again', ev.selfHealth.detail, 'ok');
+            setVerdict(run.id, {
+                outcome: 'info',
+                headline: ev.selfHealth.title,
+                summary: `### ${ev.selfHealth.title}`,
+                risk: 'low',
+                findings: [],
+                openQuestions: [],
+                testIdeas: [],
+                testsAtRisk: [],
+                confidence: 0.9,
+            });
+            await gate(pushAction(ev.selfHealth.title, ev.selfHealth.detail, 'normal', `self-recovery:${watch.id}:${ev.selfHealth.check}`), watch, run.id);
+            finishRun(run.id, 'done', 'ok');
+            return;
+        }
+        const url = ev.probe?.url ?? lastOutage?.trigger?.probe?.url ?? ev.title;
+        const downMin = lastOutage ? Math.max(1, Math.round((Date.now() - Date.parse(lastOutage.createdAt)) / 60000)) : undefined;
+        addStep(run.id, 'Probe passing again', `${url}${ev.probe?.status ? ` answered HTTP ${ev.probe.status}` : ''}`, 'ok');
+        const headline = `${host(url)} is back up${downMin ? ` after about ${downMin} min` : ''}`;
+        setVerdict(run.id, {
+            outcome: 'info',
+            headline,
+            summary: [
+                `### Recovered: ${host(url)}`,
+                downMin ? `- Down for about ${downMin} minutes.` : '',
+                lastOutage?.verdict?.suspectedCause ? `- Suspected cause at the time: ${lastOutage.verdict.suspectedCause}.` : '',
+                '- Worth a short note in the incident log while it is fresh.',
+            ]
+                .filter(Boolean)
+                .join('\n'),
+            risk: 'low',
+            findings: [],
+            openQuestions: lastOutage?.verdict?.suspectedCause ? ['Was the suspected cause confirmed?'] : [],
+            testIdeas: [],
+            testsAtRisk: [],
+            confidence: 0.9,
+        });
+        await gate(pushAction(headline, 'Probes are green again.', 'normal', `recovery:${watch.id}:${url}`), watch, run.id);
+        finishRun(run.id, 'done', 'ok');
+    });
+});
+//# sourceMappingURL=recovery.js.map