@intentius/chant 0.124.41 → 0.124.43

package/dist/pr-forge.js

@@ -70,6 +70,52 @@ function refusedMerge(err) {
     }
     throw err;
 }
+/** Why `login`'s approval does not count under `filter`'s `exclude`, or undefined. */
+function excludedWhy(filter, login) {
+    for (const e of filter?.exclude ?? []) {
+        const who = typeof e === "string" ? e : e.login;
+        if (who.toLowerCase() === login.toLowerCase())
+            return typeof e === "string" ? `${login} is excluded` : e.reason;
+    }
+    return undefined;
+}
+/**
+ * The approvers who count, and why each other one did not: an author, then
+ * `exclude`, then the forge's rule (`rule` gives a reason or undefined).
+ */
+async function countApprovers(approved, authors, filter, rule) {
+    const by = [];
+    const not = [];
+    for (const login of approved) {
+        const why = authors.has(login) ? `${login} is one of its authors` : (excludedWhy(filter, login) ?? (filter?.forgeRule ? await rule(login) : undefined));
+        if (why)
+            not.push(why);
+        else
+            by.push(login);
+    }
+    return { by, not };
+}
+/** A refusal for no approver counted, naming each one left out. */
+const noApprover = (line, not) => refuse(not.length > 0 ? `${line}: ${not.join("; ")}` : line);
+/** GitLab's access level for Developer, the least that may push. */
+const GITLAB_DEVELOPER = 30;
+/** GitHub's permissions that may approve under {@link PrApproverFilter.forgeRule}. */
+const GITHUB_WRITERS = new Set(["admin", "maintain", "write"]);
+const short = (sha) => (sha ?? "nothing").slice(0, 8);
+const pass = (reason) => ({ passed: true, reason });
+const refuse = (reason, pending = false) => ({ passed: false, ...(pending ? { pending: true } : {}), reason });
+const moved = (what, head, now) => refuse(`${what}'s head is ${short(now)}, not ${short(head)}, the commit this job checked out`);
+/** The verdict over statuses and checks: failing and still-running names, and how many reported. */
+function checksVerdict(what, head, failing, waiting, count) {
+    const names = (l) => [...new Set(l)].sort().join(", ");
+    if (failing.length > 0)
+        return refuse(`${names(failing)} failed on ${short(head)}`);
+    if (waiting.length > 0)
+        return refuse(`${names(waiting)} still running on ${short(head)}`, true);
+    if (count === 0)
+        return refuse(`no check has reported on ${what}'s head ${short(head)} yet`, true);
+    return pass(`${count} check${count === 1 ? "" : "s"} passed on ${short(head)}`);
+}
 /** The newest of some ISO 8601 times, ignoring what does not parse. */
 function newestTime(times) {
     return times.filter((t) => typeof t === "string" && !Number.isNaN(Date.parse(t))).sort((a, b) => Date.parse(b) - Date.parse(a))[0];
@@ -213,6 +259,10 @@ function threadCalls(t) {
         upsertIssue: async (marker, title, body) => (await trackIssueWith(t, marker, { title, body }, {}, false)).url,
     };
 }
+/** GitLab's merge statuses while it works out whether a merge request can merge (#4301). */
+const GITLAB_CHECKING = new Set(["checking", "unchecked", "preparing", "approvals_syncing", "cannot_be_merged_recheck"]);
+/** GitLab's commit statuses still running. */
+const GITLAB_RUNNING = new Set(["created", "waiting_for_resource", "preparing", "pending", "running", "scheduled"]);
 /** GitHub keeps a status description to 140 characters; Forgejo follows. */
 const GITHUB_DESCRIPTION = 140;
 /** GitLab keeps a status description to 255 characters. */
@@ -282,6 +332,38 @@ function githubShaped(kind, opts) {
             ...(url ? { target_url: url } : {}),
         });
     };
+    const authorsOf = async (pr) => {
+        const logins = new Set();
+        const add = (v) => {
+            if (isObject(v) && typeof v.login === "string" && v.login !== "")
+                logins.add(v.login);
+        };
+        const opened = await api.call("GET", `${repo}/pulls/${pr}`);
+        if (isObject(opened))
+            add(opened.user);
+        for (const c of await api.list(`${repo}/pulls/${pr}/commits`, pageParams, pageSize)) {
+            if (!isObject(c))
+                continue;
+            add(c.author);
+            add(c.committer);
+        }
+        return [...logins].sort();
+    };
+    const branchTip = async (branch) => {
+        let b;
+        try {
+            b = await api.call("GET", `${repo}/branches/${branch.split("/").map(encodeURIComponent).join("/")}`);
+        }
+        catch (err) {
+            if (err instanceof ForgeApiError && err.status === 404)
+                return undefined;
+            throw err;
+        }
+        // GitHub names the commit `sha`, Forgejo `id`.
+        const commit = isObject(b) && isObject(b.commit) ? b.commit : undefined;
+        return commit ? str(commit.sha) ?? str(commit.id) : undefined;
+    };
+    const headOf = (v) => (isObject(v) && isObject(v.head) ? str(v.head.sha) : undefined);
     return {
         kind,
         host,
@@ -311,22 +393,123 @@ function githubShaped(kind, opts) {
             }
             return [...standing].filter(([, state]) => state === "APPROVED").map(([login]) => login).sort();
         },
-        async authors(pr) {
-            const logins = new Set();
-            const add = (v) => {
-                if (isObject(v) && typeof v.login === "string" && v.login !== "")
-                    logins.add(v.login);
+        authors: authorsOf,
+        async prApproved(pr, head, approvers) {
+            const got = await api.call("GET", `${repo}/pulls/${pr}`);
+            const at = headOf(got);
+            if (at !== head)
+                return moved(`pull request ${pr}`, head, at);
+            // A reviewer's newest deciding review stands, as in approvers; an approval counts only of this head.
+            const standing = new Map();
+            for (const r of await api.list(`${repo}/pulls/${pr}/reviews`, pageParams, pageSize)) {
+                const login = loginOf(r);
+                if (!login || !isObject(r) || typeof r.state !== "string")
+                    continue;
+                const state = r.dismissed === true ? "DISMISSED" : r.state.toUpperCase();
+                if (state === "COMMENTED" || state === "COMMENT" || state === "PENDING")
+                    continue;
+                const commit = str(r.commit_id);
+                standing.set(login, { state, ...(commit ? { commit } : {}), ...(typeof r.official === "boolean" ? { official: r.official } : {}) });
+            }
+            const changes = [...standing].filter(([, r]) => r.state === "CHANGES_REQUESTED" || r.state === "REQUEST_CHANGES").map(([l]) => l).sort();
+            if (changes.length > 0)
+                return refuse(`${changes.join(", ")} asked for changes`);
+            const authors = new Set(await authorsOf(pr));
+            const approved = [...standing].filter(([, r]) => r.state === "APPROVED" && r.commit === head).map(([l]) => l).sort();
+            const rule = async (login) => {
+                // Forgejo marks a review official when its author may write; terragucci read a missing flag as official too.
+                if (kind === "forgejo")
+                    return standing.get(login)?.official === false ? `${login}'s review is not official` : undefined;
+                let got;
+                try {
+                    got = await api.call("GET", `${repo}/collaborators/${encodeURIComponent(login)}/permission`);
+                }
+                catch (err) {
+                    return `could not read ${login}'s access (${err instanceof Error ? err.message : String(err)})`;
+                }
+                const p = isObject(got) ? [str(got.permission), str(got.role_name)] : [];
+                return p.some((x) => x !== undefined && GITHUB_WRITERS.has(x)) ? undefined : `${login} has no write access`;
             };
-            const opened = await api.call("GET", `${repo}/pulls/${pr}`);
-            if (isObject(opened))
-                add(opened.user);
-            for (const c of await api.list(`${repo}/pulls/${pr}/commits`, pageParams, pageSize)) {
-                if (!isObject(c))
+            const { by, not } = await countApprovers(approved, authors, approvers, rule);
+            if (by.length === 0)
+                return noApprover(`no reviewer other than its authors approved its head ${short(head)}`, not);
+            return pass(`approved at ${short(head)} by ${by.join(", ")}`);
+        },
+        async prMergeable(pr, head) {
+            const got = await api.call("GET", `${repo}/pulls/${pr}`);
+            const at = headOf(got);
+            if (at !== head)
+                return moved(`pull request ${pr}`, head, at);
+            const m = isObject(got) ? got : {};
+            const into = isObject(m.base) ? str(m.base.ref) : undefined;
+            // Forgejo answers mergeable false while it still checks for conflicts, and names no state that tells the two apart, so its false is asked again.
+            if (kind === "forgejo" && m.draft === true)
+                return refuse("it is a draft");
+            if (kind === "forgejo" && m.mergeable === false)
+                return refuse(`Forgejo reports conflicts with ${into ?? "its base"}, or is still checking for them`, true);
+            if (m.mergeable === false || m.mergeable_state === "dirty")
+                return refuse(`the forge reports conflicts with ${into ?? "its base"}`);
+            if (m.mergeable !== true)
+                return refuse("the forge has not worked out yet whether it can merge", true);
+            if (kind === "github" && m.mergeable_state === "blocked")
+                return refuse(`branch protection on ${into ?? "its base"} blocks its merge`);
+            return pass(`it merges into ${into ?? "its base"} as it stands`);
+        },
+        async prUndiverged(pr, head) {
+            const got = await api.call("GET", `${repo}/pulls/${pr}`);
+            const at = headOf(got);
+            if (at !== head)
+                return moved(`pull request ${pr}`, head, at);
+            const into = isObject(got) && isObject(got.base) ? str(got.base.ref) : undefined;
+            if (!into)
+                return refuse(`the forge names no branch pull request ${pr} merges into`);
+            if (kind === "github") {
+                // behind_by: the commits on the base branch that the head does not contain.
+                const cmp = await api.call("GET", `${repo}/compare/${encodeURIComponent(into)}...${head}`);
+                const behind = isObject(cmp) ? num(cmp.behind_by) : undefined;
+                if (behind === undefined)
+                    return refuse(`the forge did not say how far ${short(head)} is behind ${into}`);
+                return behind === 0 ? pass(`${short(head)} contains ${into}`) : refuse(`${short(head)} is ${behind} commit${behind === 1 ? "" : "s"} behind ${into}`);
+            }
+            // Forgejo: the pull request's merge base is the base branch's tip exactly when the head contains it.
+            const tip = await branchTip(into);
+            const base = isObject(got) ? str(got.merge_base) : undefined;
+            if (!tip || !base)
+                return refuse(`the forge did not say where ${into} is or where ${short(head)} left it`);
+            return base === tip ? pass(`${short(head)} contains ${into} at ${short(tip)}`) : refuse(`${short(head)} does not contain ${into} at ${short(tip)}`);
+        },
+        async prChecksPassed(_pr, head, ignore = []) {
+            const skip = new Set(ignore);
+            const failing = [];
+            const waiting = [];
+            let count = 0;
+            // The combined status holds each context's newest status.
+            const combined = await api.call("GET", `${repo}/commits/${head}/status`);
+            for (const st of isObject(combined) && Array.isArray(combined.statuses) ? combined.statuses : []) {
+                const context = isObject(st) ? str(st.context) : undefined;
+                if (!context || skip.has(context))
                     continue;
-                add(c.author);
-                add(c.committer);
+                const state = str(st.state) ?? str(st.status) ?? "";
+                count++;
+                if (state === "failure" || state === "error" || state === "failed")
+                    failing.push(context);
+                else if (state === "pending" || state === "running" || state === "")
+                    waiting.push(context);
             }
-            return [...logins].sort();
+            if (kind === "github") {
+                const runs = await api.call("GET", `${repo}/commits/${head}/check-runs?per_page=100`);
+                for (const run of isObject(runs) && Array.isArray(runs.check_runs) ? runs.check_runs : []) {
+                    const name = (isObject(run) ? str(run.name) : undefined) ?? "a check";
+                    if (skip.has(name) || !isObject(run))
+                        continue;
+                    count++;
+                    if (run.status !== "completed")
+                        waiting.push(name);
+                    else if (!["success", "neutral", "skipped"].includes(String(run.conclusion)))
+                        failing.push(name);
+                }
+            }
+            return checksVerdict(`pull request ${_pr}`, head, failing, waiting, count);
         },
         async pullRequestOpen(pr) {
             try {
@@ -422,20 +605,7 @@ function githubShaped(kind, opts) {
             }
             return out.sort((a, b) => a.number - b.number);
         },
-        async branchHead(branch) {
-            let b;
-            try {
-                b = await api.call("GET", `${repo}/branches/${branch.split("/").map(encodeURIComponent).join("/")}`);
-            }
-            catch (err) {
-                if (err instanceof ForgeApiError && err.status === 404)
-                    return undefined;
-                throw err;
-            }
-            // GitHub names the commit `sha`, Forgejo `id`.
-            const commit = isObject(b) && isObject(b.commit) ? b.commit : undefined;
-            return commit ? str(commit.sha) ?? str(commit.id) : undefined;
-        },
+        branchHead: branchTip,
         async scheduledRuns(q) {
             const file = encodeURIComponent(q.workflow);
             if (kind === "github") {
@@ -594,6 +764,28 @@ export function gitlabForge(opts) {
             await api.call("PUT", `${project}/issues/${n}`, { state_event: "close" });
         },
     };
+    const authorsOf = async (mr) => {
+        const logins = new Set();
+        const merge = await api.call("GET", `${notes}/${mr}`);
+        const author = isObject(merge) ? authorOf(merge) : undefined;
+        if (author)
+            logins.add(author);
+        const emails = new Set();
+        for (const c of await api.list(`${notes}/${mr}/commits`, pageParams, 100)) {
+            if (!isObject(c))
+                continue;
+            for (const email of [str(c.author_email), str(c.committer_email)])
+                if (email)
+                    emails.add(email.toLowerCase());
+        }
+        for (const email of [...emails].sort()) {
+            const users = await api.call("GET", `/users?search=${encodeURIComponent(email)}`);
+            for (const u of Array.isArray(users) ? users : [])
+                if (isObject(u) && typeof u.username === "string")
+                    logins.add(u.username);
+        }
+        return [...logins].sort();
+    };
     return {
         kind: "gitlab",
         host,
@@ -627,27 +819,110 @@ export function gitlabForge(opts) {
                 .filter((l) => l !== undefined);
             return [...new Set(logins)].sort();
         },
-        async authors(mr) {
-            const logins = new Set();
-            const merge = await api.call("GET", `${notes}/${mr}`);
-            const author = isObject(merge) ? authorOf(merge) : undefined;
-            if (author)
-                logins.add(author);
-            const emails = new Set();
-            for (const c of await api.list(`${notes}/${mr}/commits`, pageParams, 100)) {
-                if (!isObject(c))
+        authors: authorsOf,
+        async prApproved(mr, head, approvers) {
+            const got = await api.call("GET", `${notes}/${mr}`);
+            const at = isObject(got) ? str(got.sha) : undefined;
+            if (at !== head)
+                return moved(`merge request !${mr}`, head, at);
+            // The token's own user approves for the pipeline, never as a reviewer.
+            const me = await api.call("GET", "/user");
+            const self = isObject(me) ? str(me.username) : undefined;
+            if (!self)
+                return refuse("GitLab did not say which user the job's token acts as, so no approval counts");
+            // An approval counts once it came after the latest push: the newest version of the diff.
+            const versions = await api.call("GET", `${notes}/${mr}/versions`);
+            const since = Math.max(-Infinity, ...(Array.isArray(versions) ? versions : []).map((v) => Date.parse((isObject(v) ? str(v.created_at) : undefined) ?? "")).filter(Number.isFinite));
+            const said = new Map();
+            for (const n of await api.list(`${notes}/${mr}/notes?sort=asc&order_by=created_at`, pageParams, 100)) {
+                if (!isObject(n) || n.system !== true)
+                    continue;
+                const who = authorOf(n);
+                const body = (str(n.body) ?? "").trim();
+                const what = /^approved this merge request/.test(body) ? "approved" : /^unapproved this merge request/.test(body) ? "unapproved" : /^requested changes/.test(body) ? "changes" : undefined;
+                const when = Date.parse(str(n.created_at) ?? "");
+                if (!who || who === self || !what || !Number.isFinite(when))
+                    continue;
+                const before = said.get(who);
+                const id = isObject(n.author) ? num(n.author.id) : undefined;
+                if (!before || when >= before.at)
+                    said.set(who, { what, at: when, ...(id !== undefined ? { id } : {}) });
+            }
+            const changes = [...said].filter(([, v]) => v.what === "changes").map(([w]) => w).sort();
+            if (changes.length > 0)
+                return refuse(`${changes.join(", ")} requested changes`);
+            const authors = new Set(await authorsOf(mr));
+            const approved = [...said].filter(([, v]) => v.what === "approved" && v.at > since).map(([w]) => w).sort();
+            const least = approvers?.minAccessLevel ?? GITLAB_DEVELOPER;
+            const rule = async (login) => {
+                const id = said.get(login)?.id;
+                if (id === undefined)
+                    return `GitLab did not say who ${login} is`;
+                let member;
+                try {
+                    member = await api.call("GET", `${project}/members/all/${id}`);
+                }
+                catch (err) {
+                    if (err instanceof ForgeApiError && err.status === 404)
+                        return `${login} is not a member`;
+                    return `could not read ${login}'s access (${err instanceof Error ? err.message : String(err)})`;
+                }
+                const level = isObject(member) ? (num(member.access_level) ?? 0) : 0;
+                return level >= least ? undefined : `${login} has access level ${level}, under ${least}`;
+            };
+            const { by, not } = await countApprovers(approved, authors, approvers, rule);
+            if (by.length === 0)
+                return noApprover(`no member other than its authors approved it after its latest push, ${short(head)}`, not);
+            return pass(`approved after ${short(head)} by ${by.join(", ")}`);
+        },
+        async prMergeable(mr, head) {
+            const got = await api.call("GET", `${notes}/${mr}`);
+            const m = isObject(got) ? got : {};
+            if (str(m.sha) !== head)
+                return moved(`merge request !${mr}`, head, str(m.sha));
+            const status = str(m.detailed_merge_status) ?? (m.merge_status === "can_be_merged" ? "mergeable" : (str(m.merge_status) ?? ""));
+            const into = str(m.target_branch) ?? "its target branch";
+            if (status === "conflict" || m.has_conflicts === true)
+                return refuse(`GitLab reports conflicts with ${into}`);
+            if (GITLAB_CHECKING.has(status))
+                return refuse("GitLab has not worked out yet whether it can merge", true);
+            if (status !== "mergeable")
+                return refuse(`GitLab says ${status || "nothing"} about merging it`);
+            return pass(`it merges into ${into} as it stands`);
+        },
+        async prUndiverged(mr, head) {
+            const got = await api.call("GET", `${notes}/${mr}?include_diverged_commits_count=true`);
+            const m = isObject(got) ? got : {};
+            if (str(m.sha) !== head)
+                return moved(`merge request !${mr}`, head, str(m.sha));
+            const into = str(m.target_branch) ?? "its target branch";
+            const behind = num(m.diverged_commits_count);
+            if (behind === undefined)
+                return refuse(`GitLab did not say how far ${short(head)} is behind ${into}`);
+            return behind === 0 ? pass(`${short(head)} contains ${into}`) : refuse(`${short(head)} is ${behind} commit${behind === 1 ? "" : "s"} behind ${into}`);
+        },
+        async prChecksPassed(mr, head, ignore = []) {
+            const skip = new Set(ignore);
+            // Each name's newest status; a job allowed to fail holds nothing back.
+            const newest = new Map();
+            for (const st of await api.list(`${project}/repository/commits/${head}/statuses?all=true`, pageParams, 100)) {
+                const name = isObject(st) ? str(st.name) : undefined;
+                if (!name || skip.has(name) || !isObject(st))
                     continue;
-                for (const email of [str(c.author_email), str(c.committer_email)])
-                    if (email)
-                        emails.add(email.toLowerCase());
+                const had = newest.get(name);
+                if (!had || (num(st.id) ?? 0) > (num(had.id) ?? 0))
+                    newest.set(name, st);
             }
-            for (const email of [...emails].sort()) {
-                const users = await api.call("GET", `/users?search=${encodeURIComponent(email)}`);
-                for (const u of Array.isArray(users) ? users : [])
-                    if (isObject(u) && typeof u.username === "string")
-                        logins.add(u.username);
+            const failing = [];
+            const waiting = [];
+            for (const [name, st] of newest) {
+                const state = str(st.status) ?? "";
+                if ((state === "failed" || state === "canceled") && st.allow_failure !== true)
+                    failing.push(name);
+                else if (GITLAB_RUNNING.has(state))
+                    waiting.push(name);
             }
-            return [...logins].sort();
+            return checksVerdict(`merge request !${mr}`, head, failing, waiting, newest.size);
         },
         async pullRequestOpen(mr) {
             try {

package/dist/pr-loop.d.ts

@@ -47,6 +47,7 @@
  * `identity.gates` entry covers every member.
  */
 import type { ChangeSetDocument } from "./change-set.js";
+import type { PrRequireOutcome } from "./pr-requires.js";
 /** The schema a pull-request report names in `$schema`. */
 export declare const PR_REPORT_SCHEMA_ID = "https://intentius.io/chant/schemas/workspace/pr-report/v1/pr-report.schema.json";
 /** The read-contract version the report follows. */
@@ -69,6 +70,8 @@ export declare const PR_REPORT_HOOKS_FLOOR = "0.124.41";
 export declare const PR_REPORT_OVERDUE_FLOOR = "0.124.41";
 /** The first chant whose report can carry `policy` and the `policy-denied` and `policy-error` refusals (#4294). */
 export declare const PR_REPORT_POLICY_FLOOR = "0.124.41";
+/** The first chant whose apply report can carry `beforeMerge` and the `requires-unmet` and `before-merge-off` refusals (#4301, ws-106). */
+export declare const PR_REPORT_BEFORE_MERGE_FLOOR = "0.124.42";
 /** The gate a pull request's apply waits on, unless the pipeline names another. */
 export declare const PR_APPLY_GATE = "pr-apply";
 /**
@@ -246,7 +249,15 @@ export type PrRefusal =
 /** `ci.policy` at base denied the plan (#4294), and no override of it counts. */
  | "policy-denied"
 /** `ci.policy` at base could not be run, or gave no answer chant can read (#4294). */
- | "policy-error";
+ | "policy-error"
+/** `pr-apply --before-merge` (#4301): the pull request is not approved, mergeable, undiverged or green; `beforeMerge` says which. */
+ | "requires-unmet"
+/** `pr-apply --before-merge`: the declaration at base does not set `ci.workflow` to `apply-before-merge` for the member. */
+ | "before-merge-off";
+/** An apply before merge (#4301, ws-106): the requires checks the forge answered, in order. */
+export interface PrBeforeMerge {
+    requires: PrRequireOutcome[];
+}
 /**
  * One wave of an apply with `--wave-gate` (#4003): what it planned, where it
  * got to, and which approval it applied or waits under.
@@ -424,6 +435,12 @@ export interface PrReport {
      * within contract 1 by chant {@link PR_REPORT_POLICY_FLOOR}.
      */
     policy?: PrPolicyReport;
+    /**
+     * `pr-apply --before-merge` (#4301): the requires checks. Absent on every
+     * other stage. Added within contract 1 by chant
+     * {@link PR_REPORT_BEFORE_MERGE_FLOOR}.
+     */
+    beforeMerge?: PrBeforeMerge;
 }
 /** The counts a member's entries add up to. */
 export declare function memberCounts(doc: Pick<ChangeSetDocument, "summary">, member: string): PrMemberCounts;

package/dist/pr-loop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pr-loop.d.ts","sourceRoot":"","sources":["../src/pr-loop.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pr-loop.d.ts","sourceRoot":"","sources":["../src/pr-loop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAEH,OAAO,KAAK,EAAmB,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGtD,2DAA2D;AAC3D,eAAO,MAAM,mBAAmB,oFAAoF,CAAC;AAErH,oDAAoD;AACpD,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC,wEAAwE;AACxE,eAAO,MAAM,gCAAgC,aAAa,CAAC;AAE3D,6EAA6E;AAC7E,eAAO,MAAM,qBAAqB,aAAa,CAAC;AAChD;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,aAAa,CAAC;AAE1D,yFAAyF;AACzF,eAAO,MAAM,sBAAsB,aAAa,CAAC;AAEjD,8DAA8D;AAC9D,eAAO,MAAM,qBAAqB,aAAa,CAAC;AAEhD,qEAAqE;AACrE,eAAO,MAAM,uBAAuB,aAAa,CAAC;AAElD,mHAAmH;AACnH,eAAO,MAAM,sBAAsB,aAAa,CAAC;AAEjD,2IAA2I;AAC3I,eAAO,MAAM,4BAA4B,aAAa,CAAC;AAEvD,mFAAmF;AACnF,eAAO,MAAM,aAAa,aAAa,CAAC;AAExC;;;GAGG;AACH,wBAAgB,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,8HAA8H;AAC9H,eAAO,MAAM,UAAU,QAAqC,CAAC;AAE7D,+GAA+G;AAC/G,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,wDAAwD;AACxD,eAAO,MAAM,kBAAkB;aAAK,IAAI,EAAE,YAAY;aAAE,KAAK,EAAE,aAAa;aAAE,MAAM,EAAE,cAAc;CAAW,CAAC;AAEhH,6GAA6G;AAC7G,MAAM,MAAM,OAAO,GAAG,MAAM,OAAO,kBAAkB,CAAC;AAEtD,0GAA0G;AAC1G,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,yEAAyE;AACzE,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,+BAA+B;AAC/B,MAAM,MAAM,cAAc;AACxB,2EAA2E;AACzE,SAAS;AACX,uBAAuB;GACrB,aAAa;AACf,iCAAiC;GAC/B,SAAS;AACX,wBAAwB;GACtB,QAAQ;AACV,yDAAyD;GACvD,SAAS;AACX;;;;GAIG;GACD,SAAS,CAAC;AAEd,MAAM,WAAW,QAAQ;IACvB,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,4FAA4F;IAC5F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8GAA8G;IAC9G,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,+FAA+F;AAC/F,MAAM,WAAW,OAAO;IACtB,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,UAAU,CAAC;IACrB,sHAAsH;IACtH,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,aAAa,CAAC;IACzD,uFAAuF;IACvF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,SAAS,EAAE,iBAAiB,CAAC;CAC9B;AAED,wDAAwD;AACxD,MAAM,WAAW,UAAU;IACzB;;;;OAIG;IACH,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;IAC3C,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,yBAAyB;AACzB,MAAM,MAAM,QAAQ;AAClB,wCAAwC;AACtC,SAAS;AACX;;;;GAIG;GACD,UAAU;AACZ,sFAAsF;GACpF,aAAa;AACf,6DAA6D;GAC3D,SAAS;AACX,yCAAyC;GACvC,SAAS;AACX,yEAAyE;GACvE,QAAQ;AACV;;;GAGG;GACD,cAAc;AAChB,mDAAmD;GACjD,SAAS;AACX;;;;GAIG;GACD,SAAS,CAAC;AAEd,4BAA4B;AAC5B,MAAM,MAAM,SAAS;AACnB,4DAA4D;AAC1D,cAAc;AAChB,6EAA6E;GAC3E,cAAc;AAChB,qFAAqF;GACnF,gBAAgB;AAClB,6GAA6G;GAC3G,iBAAiB;AACnB,2EAA2E;GACzE,iBAAiB;AACnB,sHAAsH;GACpH,mBAAmB;AACrB,wGAAwG;GACtG,mBAAmB;AACrB,oGAAoG;GAClG,cAAc;AAChB,uGAAuG;GACrG,QAAQ;AACV,iFAAiF;GAC/E,eAAe;AACjB,sFAAsF;GACpF,cAAc;AAChB,qIAAqI;GACnI,gBAAgB;AAClB,4HAA4H;GAC1H,kBAAkB,CAAC;AAEvB,+FAA+F;AAC/F,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,sEAAsE;IACtE,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,aAAa,GAAG,SAAS,CAAC;IACzD;;;;OAIG;IACH,QAAQ,EAAE,cAAc,GAAG,MAAM,CAAC;IAClC,yFAAyF;IACzF,IAAI,EAAE,MAAM,CAAC;IACb,yFAAyF;IACzF,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uFAAuF;IACvF,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,gGAAgG;AAChG,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,0FAA0F;IAC1F,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,6FAA6F;IAC7F,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;IAC/C,kDAAkD;IAClD,MAAM,EAAE,UAAU,GAAG,KAAK,CAAC;IAC3B,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClD,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,QAAQ,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACtE,2DAA2D;IAC3D,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,sFAAsF;IACtF,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,0FAA0F;IAC1F,OAAO,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;CACvC;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,OAAO,mBAAmB,CAAC;IACpC,QAAQ,EAAE,OAAO,kBAAkB,CAAC;IACpC,KAAK,EAAE,OAAO,CAAC;IACf,oDAAoD;IACpD,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,oGAAoG;IACpG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2FAA2F;IAC3F,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,QAAQ,CAAC;IACjB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,OAAO,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAChC;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3C;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1C;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IACnB,QAAQ,EAAE,UAAU,CAAC;IACrB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;IACtB,mIAAmI;IACnI,SAAS,EAAE;QACT,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,4DAA4D;QAC5D,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC;KACnB,CAAC;IACF,OAAO,EAAE,QAAQ,EAAE,CAAC;IACpB,SAAS,EAAE,iBAAiB,CAAC;IAC7B;;;OAGG;IACH,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC;IACxB;;;;OAIG;IACH,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB;;;;OAIG;IACH,WAAW,CAAC,EAAE,aAAa,CAAC;CAC7B;AAED,+CAA+C;AAC/C,wBAAgB,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,iBAAiB,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,CAIpG;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAG/F;AAED,oEAAoE;AACpE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,GAAG,MAAM,GAAG,QAAQ,CAAC,EAAE,QAAQ,SAAU,GAAG,MAAM,CAE7G;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC,GAAG,MAAM,CAMzG;AA8ID;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CA6F1G;AAED,8EAA8E;AAC9E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,CA6D5D;AAED,qGAAqG;AACrG,wBAAgB,aAAa,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CASjF"}

package/dist/pr-loop.js

@@ -69,6 +69,8 @@ export const PR_REPORT_HOOKS_FLOOR = "0.124.41";
 export const PR_REPORT_OVERDUE_FLOOR = "0.124.41";
 /** The first chant whose report can carry `policy` and the `policy-denied` and `policy-error` refusals (#4294). */
 export const PR_REPORT_POLICY_FLOOR = "0.124.41";
+/** The first chant whose apply report can carry `beforeMerge` and the `requires-unmet` and `before-merge-off` refusals (#4301, ws-106). */
+export const PR_REPORT_BEFORE_MERGE_FLOOR = "0.124.42";
 /** The gate a pull request's apply waits on, unless the pipeline names another. */
 export const PR_APPLY_GATE = "pr-apply";
 /**
@@ -401,6 +403,11 @@ export function prStatusDescription(report) {
                 text = "refused: an earlier wave has not applied";
                 break;
             }
+            if (report.refusal === "requires-unmet" || report.refusal === "before-merge-off") {
+                const unmet = (report.beforeMerge?.requires ?? []).filter((r) => !r.passed).map((r) => r.name);
+                text = report.refusal === "before-merge-off" ? "refused: this workspace does not apply before merge" : `refused: ${unmet.join(", ") || "a require"} unmet for an apply before merge`;
+                break;
+            }
             if (report.refusal === "policy-denied" || report.refusal === "policy-error") {
                 text = report.refusal === "policy-denied" ? `refused: the policy denied the plan (${(report.policy?.rules ?? []).join(", ")})` : "refused: the policy could not be checked";
                 break;

package/dist/pr-requires.d.ts

@@ -0,0 +1,47 @@
+/**
+ * The requires checks of an apply before merge (#4301, ws-106): the pull
+ * request is approved, mergeable, undiverged and its checks passed, each
+ * asked of the forge through its {@link PrForge} method. All four must pass.
+ *
+ * The checks are terragucci's `apply.requires` (comment-apply.ts:781-860 at
+ * INTENTIUS/terragucci e6cb431). A product may leave one out with `only`
+ * (#4336); chant's own `pr-apply --before-merge` passes no `only`, so it asks
+ * all four, as ws-106 requires. A check the
+ * forge has not settled, such as GitHub working out whether a pull request
+ * can merge, is asked again a few times before it counts as unmet.
+ *
+ * Like ./pr-forge.ts this imports nothing beyond it, so a product bundles it
+ * without the TypeScript toolchain.
+ */
+import type { PrApproverFilter, PrForge, PrRequireResult } from "./pr-forge.js";
+/** The four checks, in the order they run and the report lists them. */
+export declare const PR_APPLY_REQUIRES: readonly ["approved", "mergeable", "undiverged", "checks"];
+export type PrApplyRequire = (typeof PR_APPLY_REQUIRES)[number];
+/** One check as the pull-request report's `beforeMerge.requires` holds it. */
+export interface PrRequireOutcome extends PrRequireResult {
+    name: PrApplyRequire;
+}
+export interface PrRequiresOptions {
+    /**
+     * The checks to ask (#4336). One left out passes with the reason "not
+     * required" and makes no forge call. Default: all four.
+     */
+    only?: readonly PrApplyRequire[];
+    /** Who counts as an approver for `approved` (#4337). Default: anyone other than the authors. */
+    approvers?: PrApproverFilter;
+    /** Status names the `checks` require leaves out: the apply's own. */
+    ignore?: readonly string[];
+    /** How many times a pending check is asked in all. Default 5. */
+    reads?: number;
+    /** The wait between reads. Default 3 seconds. */
+    wait?: (ms: number) => Promise<void>;
+}
+/**
+ * Ask `forge` each of the four checks for pull request `pr` at `head`. A
+ * forge client without a method, or a call that throws, gives an unmet
+ * check with the reason, so nothing applies on a check nobody made.
+ */
+export declare function checkPrRequires(forge: PrForge, pr: number, head: string, opts?: PrRequiresOptions): Promise<PrRequireOutcome[]>;
+/** The unmet checks as one line, or null when all four passed. */
+export declare function unmetRequires(outcomes: readonly PrRequireOutcome[]): string | null;
+//# sourceMappingURL=pr-requires.d.ts.map

package/dist/pr-requires.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-requires.d.ts","sourceRoot":"","sources":["../src/pr-requires.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7E,wEAAwE;AACxE,eAAO,MAAM,iBAAiB,YAAI,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,CAAU,CAAC;AAE5F,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE,8EAA8E;AAC9E,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,IAAI,EAAE,cAAc,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,IAAI,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACjC,gGAAgG;IAChG,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,qEAAqE;IACrE,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAKD;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAkCzI;AAED,kEAAkE;AAClE,wBAAgB,aAAa,CAAC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,GAAG,MAAM,GAAG,IAAI,CAIlF"}

package/dist/pr-requires.js

@@ -0,0 +1,53 @@
+/** The four checks, in the order they run and the report lists them. */
+export const PR_APPLY_REQUIRES = ["approved", "mergeable", "undiverged", "checks"];
+const READS = 5;
+const WAIT_MS = 3000;
+/**
+ * Ask `forge` each of the four checks for pull request `pr` at `head`. A
+ * forge client without a method, or a call that throws, gives an unmet
+ * check with the reason, so nothing applies on a check nobody made.
+ */
+export async function checkPrRequires(forge, pr, head, opts = {}) {
+    const wait = opts.wait ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
+    const reads = Math.max(1, opts.reads ?? READS);
+    const ask = {
+        approved: forge.prApproved ? () => forge.prApproved(pr, head, opts.approvers) : undefined,
+        mergeable: forge.prMergeable ? () => forge.prMergeable(pr, head) : undefined,
+        undiverged: forge.prUndiverged ? () => forge.prUndiverged(pr, head) : undefined,
+        checks: forge.prChecksPassed ? () => forge.prChecksPassed(pr, head, opts.ignore ?? []) : undefined,
+    };
+    const out = [];
+    const asked = new Set(opts.only ?? PR_APPLY_REQUIRES);
+    for (const name of PR_APPLY_REQUIRES) {
+        if (!asked.has(name)) {
+            out.push({ name, passed: true, reason: "not required" });
+            continue;
+        }
+        const call = ask[name];
+        if (!call) {
+            out.push({ name, passed: false, reason: `this ${forge.kind} client cannot say` });
+            continue;
+        }
+        let result;
+        for (let read = 1;; read++) {
+            try {
+                result = await call();
+            }
+            catch (err) {
+                result = { passed: false, reason: `could not ask ${forge.kind}: ${err instanceof Error ? err.message : String(err)}` };
+            }
+            if (result.passed || !result.pending || read >= reads)
+                break;
+            await wait(WAIT_MS);
+        }
+        out.push({ name, ...result });
+    }
+    return out;
+}
+/** The unmet checks as one line, or null when all four passed. */
+export function unmetRequires(outcomes) {
+    const unmet = outcomes.filter((o) => !o.passed);
+    if (unmet.length === 0)
+        return null;
+    return unmet.map((o) => `${o.name}: ${o.reason}`).join("; ");
+}