announceHead with its mesh/merge-gate pending, the weighing of trunk and sibling moves (passPulls, trunksMoved, siblingMoves, GateWriter) and their files on disk, the pass's pull-passing half with its 60 s retry, and the 10-minute keep-main-rules step go. A pull request's new head is said as pull.updated from the forge's event alone; the seat's status writes through the client; pollRepos, pollMerged and readAllAtStart stay. Builds: design 47 H §764 (the forge module: the merge-check machinery, its poll and timer), §762; H-A-28, H-A-100 Claude-Session: https://claude.ai/code/session_01JG73KHUnBze48rdua8u2sy
40 lines
2.1 KiB
TypeScript
40 lines
2.1 KiB
TypeScript
// What the forge's events ask of the announcer, and the one pass at a start (issue 1422, notes 10 and 11). Nothing polls the
|
|
// forge for heads: a pull request's new head is said as pull.updated when its event is heard, a merge or a close by its
|
|
// event and by the pass over every repository's merges at the start (design 47 H §764; H-A-100).
|
|
//
|
|
// Apart from index.ts, which has side effects at import, so these are tested with the announcers injected.
|
|
|
|
import type { ForgeEvent } from "./webhook.js";
|
|
|
|
export interface ActDeps<R, P> {
|
|
getRepo(owner: string, repo: string): Promise<R>;
|
|
getPull(owner: string, repo: string, number: number): Promise<P & { state?: string; merged?: boolean }>;
|
|
announceUpdated(repo: R, pull: P): Promise<unknown>;
|
|
announceMerge(repo: R, pull: P): Promise<unknown>;
|
|
announceClosed(repo: R, pull: P): Promise<unknown>;
|
|
}
|
|
|
|
const HEAD_EVENTS = ["forge.pull-request.opened", "forge.pull-request.synchronized", "forge.pull-request.reopened"];
|
|
|
|
/**
|
|
* What the forge's event asks of the announcer at once: a new head is said, a merge, a close without a merge, and a pull
|
|
* request retargeted (an edit: the head is said into the base it now has).
|
|
*/
|
|
export async function actOn<R, P>(event: ForgeEvent, d: ActDeps<R, P>): Promise<void> {
|
|
const b = event.body as { owner?: string; repo?: string; number?: number; merged?: boolean };
|
|
if (!b.owner || !b.repo || !b.number) return;
|
|
const edited = event.name === "forge.pull-request.edited";
|
|
const closed = event.name === "forge.pull-request.closed";
|
|
const head = HEAD_EVENTS.includes(event.name) || edited;
|
|
const merged = event.name === "forge.pull-request.merged";
|
|
if (!head && !merged && !closed) return;
|
|
if (closed && b.merged) return; // a merge is weighed with its own event (ADR 0382 §5)
|
|
const [repo, pull] = await Promise.all([d.getRepo(b.owner, b.repo), d.getPull(b.owner, b.repo, b.number)]);
|
|
if (closed) {
|
|
await d.announceClosed(repo, pull);
|
|
return;
|
|
}
|
|
if (head && pull.state === "open") await d.announceUpdated(repo, pull);
|
|
if (merged) await d.announceMerge(repo, pull);
|
|
}
|