pr-merge-queue 0.0.0-stage → 0.0.0

package/dist/open-pr/steps.d.mts

@@ -0,0 +1,23 @@
+/** What the observed state allows, and nothing that talks to GitHub. */
+/**
+ * The `Merge-After:` line for a chained pull request, or `undefined` when
+ * nothing was declared. One line, in the order given, which is the form
+ * `unblock-prs` reads.
+ */
+export declare const mergeAfterTrailer: (numbers: readonly number[]) => string | undefined;
+/**
+ * What to declare with `Merge-After:`: what was asked for, and — for a pull
+ * request stacked on another — that one first. The base already says it, and
+ * `unblock-prs` and the reports read the base alone; the trailer is written
+ * as well so that the order is stated in the body like every other, and
+ * survives the base being moved by hand.
+ */
+export declare const withStackParent: (mergeAfter: readonly number[], parent: number | undefined) => readonly number[];
+/**
+ * `body` with `numbers` declared in it as well: added to the `Merge-After:`
+ * line it opens with, which is where this command writes one, or in a line
+ * of their own before it. The numbers are what the issues it closes start
+ * after and the body does not yet say (`openPullRequest`).
+ */
+export declare const withInheritedMergeAfter: (body: string, numbers: readonly number[]) => string;
+//# sourceMappingURL=steps.d.mts.map

package/dist/open-pr/steps.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.d.mts","sourceRoot":"","sources":["../../src/open-pr/steps.mts"],"names":[],"mappings":"AAAA,wEAAwE;AAIxE;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,YACnB,SAAS,MAAM,EAAE,KACzB,MAAM,GAAG,SAGG,CAAC;AAEhB;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,eACd,SAAS,MAAM,EAAE,UACrB,MAAM,GAAG,SAAS,KACzB,SAAS,MAAM,EAGiC,CAAC;AAEpD;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,SAC5B,MAAM,WACH,SAAS,MAAM,EAAE,KACzB,MAgBF,CAAC"}

package/dist/open-pr/steps.mjs

@@ -0,0 +1,38 @@
+
+import { Arr } from 'ts-data-forge';
+
+
+
+
+
+export const mergeAfterTrailer = (numbers) => Arr.isNonEmpty(numbers)
+    ? `Merge-After: ${numbers.map((n) => `#${n}`).join(', ')}`
+    : undefined;
+
+
+
+
+
+
+
+export const withStackParent = (mergeAfter, parent) => parent === undefined
+    ? mergeAfter
+    : Arr.uniq(Arr.toUnshifted(parent)(mergeAfter));
+
+
+
+
+
+
+export const withInheritedMergeAfter = (body, numbers) => {
+    const trailer = mergeAfterTrailer(numbers);
+    if (trailer === undefined) {
+        return body;
+    }
+    const [first = '', ...rest] = body.split('\n');
+    if (/^merge-after\s*:/iu.test(first)) {
+        return Arr.toUnshifted(`${first.trimEnd()}, ${numbers.map((n) => `#${n}`).join(', ')}`)(rest).join('\n');
+    }
+    return body === '' ? `${trailer}\n` : `${trailer}\n\n${body}`;
+};
+//# sourceMappingURL=steps.mjs.map

package/dist/open-pr/steps.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.mjs","sourceRoot":"","sources":["../../src/open-pr/steps.mts"],"names":[],"mappings":"AAAA,wEAAwE;AAExE,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAEpC;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,OAA0B,EACN,EAAE,CACtB,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC;IACrB,CAAC,CAAE,gBAAgB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAY;IACrE,CAAC,CAAC,SAAS,CAAC;AAEhB;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,UAA6B,EAC7B,MAA0B,EACP,EAAE,CACrB,MAAM,KAAK,SAAS;IAClB,CAAC,CAAC,UAAU;IACZ,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,IAAY,EACZ,OAA0B,EAClB,EAAE;IACV,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAE3C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,KAAK,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE/C,IAAI,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,OAAO,GAAG,CAAC,WAAW,CACpB,GAAG,KAAK,CAAC,OAAO,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAChE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IAED,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,OAAO,OAAO,IAAI,EAAE,CAAC;AAChE,CAAC,CAAC"}

package/dist/open-pr/types.d.mts

@@ -0,0 +1,179 @@
+/** The shapes this command passes around, and what the API answers with. */
+import * as t from 'ts-fortress';
+/**
+ * The fields the run needs, and no more. Deliberately smaller than
+ * `unblock-prs`'s pull request: this command decides two things — whether
+ * the pull request exists, and whether it is a draft — and asking for less
+ * keeps what a failure can be about small.
+ *
+ * `nodeId` is here because taking a pull request out of draft is a GraphQL
+ * mutation, which addresses it by node id rather than by number. It is
+ * carried on the read that already happens rather than fetched again.
+ */
+export type PullRequest = Readonly<{
+    number: number;
+    nodeId: string;
+    isDraft: boolean;
+}>;
+/**
+ * What `GET /repos/{owner}/{repo}/pulls[/{number}]` answers with, in the
+ * REST API's own names. Only the fields above are declared; everything else
+ * in that response is ignored.
+ */
+export declare const PullRequestResponseSchema: Readonly<{
+    typeName: string;
+    defaultValue: Readonly<{
+        draft: boolean;
+        node_id: string;
+        number: number;
+    }>;
+    is: (a: unknown) => a is Readonly<{
+        draft: boolean;
+        node_id: string;
+        number: number;
+    }>;
+    assertIs: (a: unknown) => asserts a is Readonly<{
+        draft: boolean;
+        node_id: string;
+        number: number;
+    }>;
+    cast: (a: unknown) => Readonly<{
+        draft: boolean;
+        node_id: string;
+        number: number;
+    }>;
+    fill: (a: unknown) => Readonly<{
+        draft: boolean;
+        node_id: string;
+        number: number;
+    }>;
+    prune: <B extends Readonly<{
+        draft: boolean;
+        node_id: string;
+        number: number;
+    }>>(a: B) => Readonly<{
+        draft: boolean;
+        node_id: string;
+        number: number;
+    }>;
+    validate: (a: unknown) => t.Result<Readonly<{
+        draft: boolean;
+        node_id: string;
+        number: number;
+    }>, readonly Readonly<{
+        path: readonly string[];
+        actualValue: unknown;
+        expectedType: string;
+        typeName: string;
+        details?: t.ValidationErrorDetails | undefined;
+    }>[]>;
+    structure?: t.TypeStructure;
+    annotations?: t.TypeAnnotations;
+    optional?: true;
+}> & Readonly<{
+    shape: {
+        readonly number: t.ConstrainedType<number, Readonly<{
+            readonly finite: undefined;
+            readonly int: undefined;
+            readonly safeInteger: undefined;
+            readonly nonZero: undefined;
+            readonly negative: undefined;
+            readonly nonNegative: undefined;
+            readonly positive: undefined;
+            readonly nonPositive: undefined;
+            readonly gt: undefined;
+            readonly gte: undefined;
+            readonly min: undefined;
+            readonly lt: undefined;
+            readonly lte: undefined;
+            readonly max: undefined;
+            readonly multipleOf: undefined;
+            readonly step: undefined;
+        }>>;
+        readonly node_id: t.ConstrainedType<string, Readonly<{
+            readonly nonempty: undefined;
+            readonly minLength: undefined;
+            readonly maxLength: undefined;
+            readonly startsWith: undefined;
+            readonly endsWith: undefined;
+            readonly includes: undefined;
+            readonly uppercase: undefined;
+            readonly lowercase: undefined;
+            readonly regex: undefined;
+        }>>;
+        readonly draft: Readonly<{
+            typeName: string;
+            defaultValue: boolean;
+            is: (a: unknown) => a is boolean;
+            assertIs: (a: unknown) => asserts a is boolean;
+            cast: (a: unknown) => boolean;
+            fill: (a: unknown) => boolean;
+            prune: <B extends boolean>(a: B) => boolean;
+            validate: (a: unknown) => t.Result<boolean, readonly Readonly<{
+                path: readonly string[];
+                actualValue: unknown;
+                expectedType: string;
+                typeName: string;
+                details?: t.ValidationErrorDetails | undefined;
+            }>[]>;
+            structure?: t.TypeStructure;
+            annotations?: t.TypeAnnotations;
+            optional?: true;
+        }>;
+    };
+}>;
+export declare const PullRequestListResponseSchema: Readonly<{
+    typeName: string;
+    defaultValue: readonly Readonly<{
+        draft: boolean;
+        node_id: string;
+        number: number;
+    }>[];
+    is: (a: unknown) => a is readonly Readonly<{
+        draft: boolean;
+        node_id: string;
+        number: number;
+    }>[];
+    assertIs: (a: unknown) => asserts a is readonly Readonly<{
+        draft: boolean;
+        node_id: string;
+        number: number;
+    }>[];
+    cast: (a: unknown) => readonly Readonly<{
+        draft: boolean;
+        node_id: string;
+        number: number;
+    }>[];
+    fill: (a: unknown) => readonly Readonly<{
+        draft: boolean;
+        node_id: string;
+        number: number;
+    }>[];
+    prune: <B extends readonly Readonly<{
+        draft: boolean;
+        node_id: string;
+        number: number;
+    }>[]>(a: B) => readonly Readonly<{
+        draft: boolean;
+        node_id: string;
+        number: number;
+    }>[];
+    validate: (a: unknown) => t.Result<readonly Readonly<{
+        draft: boolean;
+        node_id: string;
+        number: number;
+    }>[], readonly Readonly<{
+        path: readonly string[];
+        actualValue: unknown;
+        expectedType: string;
+        typeName: string;
+        details?: t.ValidationErrorDetails | undefined;
+    }>[]>;
+    structure?: t.TypeStructure;
+    annotations?: t.TypeAnnotations;
+    optional?: true;
+}>;
+export type PullRequestResponse = t.TypeOf<typeof PullRequestResponseSchema>;
+/** The REST response in this command's own terms. */
+export declare const toPullRequest: (response: PullRequestResponse) => PullRequest;
+//# sourceMappingURL=types.d.mts.map

package/dist/open-pr/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","sourceRoot":"","sources":["../../src/open-pr/types.mts"],"names":[],"mappings":"AAAA,4EAA4E;AAE5E,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AAEjC;;;;;;;;;GASG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIpC,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAqC,CAAC;AAEhF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE7E,qDAAqD;AACrD,eAAO,MAAM,aAAa,aAAc,mBAAmB,KAAG,WAKjD,CAAC"}

package/dist/open-pr/types.mjs

@@ -0,0 +1,20 @@
+
+import * as t from 'ts-fortress';
+
+
+
+
+
+export const PullRequestResponseSchema = t.record({
+    number: t.number(),
+    node_id: t.string(),
+    draft: t.boolean(),
+});
+export const PullRequestListResponseSchema = t.array(PullRequestResponseSchema);
+
+export const toPullRequest = (response) => ({
+    number: response.number,
+    nodeId: response.node_id,
+    isDraft: response.draft,
+});
+//# sourceMappingURL=types.mjs.map

package/dist/open-pr/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","sourceRoot":"","sources":["../../src/open-pr/types.mts"],"names":[],"mappings":"AAAA,4EAA4E;AAE5E,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AAkBjC;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;CACnB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;AAIhF,qDAAqD;AACrD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,QAA6B,EAAe,EAAE,CAC1E,CAAC;IACC,MAAM,EAAE,QAAQ,CAAC,MAAM;IACvB,MAAM,EAAE,QAAQ,CAAC,OAAO;IACxB,OAAO,EAAE,QAAQ,CAAC,KAAK;CACxB,CAAU,CAAC"}

package/dist/pr-report/github.d.mts

@@ -0,0 +1,59 @@
+/** Everything that talks to GitHub, and nothing that decides. */
+import { type MergedPullRequest, type OpenIssue, type PullRequestFacts, type QueueComments, type ReferenceStatus, type RepoRef } from 'pr-report-core';
+import { Result } from 'ts-data-forge';
+export type Client = Readonly<{
+    /** Whether a token was found, which decides how much can be read. */
+    authenticated: boolean;
+    /** What pull requests target unless they are stacked. */
+    defaultBranch: (repo: RepoRef) => Promise<Result<string, string>>;
+    /**
+     * The contexts GitHub requires on `branch`, every ruleset that applies to
+     * it together (`pr-report-core`'s `requirementsOfRules`).
+     */
+    requiredContexts: (repo: RepoRef, branch: string) => Promise<Result<readonly string[], string>>;
+    facts: (repo: RepoRef) => Promise<Result<readonly PullRequestFacts[], string>>;
+    /**
+     * The pull requests that landed in the last `withinDays` days, newest
+     * first. One request: the closed list, sorted by when it last changed.
+     */
+    merged: (repo: RepoRef, withinDays: number, limit: number) => Promise<Result<readonly MergedPullRequest[], string>>;
+    /**
+     * What the queue's comments say on each of `pulls` — the set-aside comment
+     * `unblock-prs` writes and the claim of whoever is fixing it — by the
+     * token's own account, which is what both are trusted by. Empty without a
+     * token, or one whose account cannot be read.
+     */
+    queueComments: (repo: RepoRef, defaultBranch: string, pulls: readonly PullRequestFacts[]) => Promise<ReadonlyMap<number, QueueComments>>;
+    /** The open issues, most recently updated first, at most `limit`. */
+    issues: (repo: RepoRef, limit: number) => Promise<Result<readonly OpenIssue[], string>>;
+    /**
+     * Whether each of `numbers` is an open issue, and what its body declares
+     * with `Start-After:`: one request each, for the issues the open pull
+     * requests close that the open list did not cover. One that cannot be read
+     * is left out, and declares nothing.
+     */
+    issueBodies: (repo: RepoRef, numbers: readonly number[]) => Promise<ReadonlyMap<number, IssueBody>>;
+    /**
+     * Where each of `numbers` — what the issues' `Start-After:` names beyond
+     * the open lists — stands: one request each, an issue or a pull request
+     * alike. One that cannot be read is left out, and is unknown.
+     */
+    references: (repo: RepoRef, numbers: readonly number[]) => Promise<ReadonlyMap<number, ReferenceStatus>>;
+}>;
+/** What {@link Client.issueBodies} reads of one issue. */
+export type IssueBody = Readonly<{
+    open: boolean;
+    startAfter: readonly number[];
+}>;
+/**
+ * A client for the public REST API, using a token when one is in the
+ * environment and going without when there is not.
+ *
+ * Unauthenticated works because the repository is public, and one report a
+ * day fits inside the 60 requests an hour an anonymous caller gets — roughly
+ * three per pull request, for the comparison and the two kinds of check.
+ * A token raises that to 5000 and, through one GraphQL query, replaces the
+ * issue links read out of the bodies with the ones GitHub itself holds.
+ */
+export declare const createClient: (token: string | undefined, baseUrl?: string) => Client;
+//# sourceMappingURL=github.d.mts.map

package/dist/pr-report/github.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.mts","sourceRoot":"","sources":["../../src/pr-report/github.mts"],"names":[],"mappings":"AAAA,iEAAiE;AAEjE,OAAO,EAeL,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,OAAO,EACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAO,MAAM,EAAE,MAAM,eAAe,CAAC;AAmM5C,MAAM,MAAM,MAAM,GAAG,QAAQ,CAAC;IAC5B,qEAAqE;IACrE,aAAa,EAAE,OAAO,CAAC;IACvB,yDAAyD;IACzD,aAAa,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAClE;;;OAGG;IACH,gBAAgB,EAAE,CAChB,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,MAAM,KACX,OAAO,CAAC,MAAM,CAAC,SAAS,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;IAChD,KAAK,EAAE,CACL,IAAI,EAAE,OAAO,KACV,OAAO,CAAC,MAAM,CAAC,SAAS,gBAAgB,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1D;;;OAGG;IACH,MAAM,EAAE,CACN,IAAI,EAAE,OAAO,EACb,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,KACV,OAAO,CAAC,MAAM,CAAC,SAAS,iBAAiB,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3D;;;;;OAKG;IACH,aAAa,EAAE,CACb,IAAI,EAAE,OAAO,EACb,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,SAAS,gBAAgB,EAAE,KAC/B,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;IACjD,qEAAqE;IACrE,MAAM,EAAE,CACN,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,MAAM,KACV,OAAO,CAAC,MAAM,CAAC,SAAS,SAAS,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD;;;;;OAKG;IACH,WAAW,EAAE,CACX,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,SAAS,MAAM,EAAE,KACvB,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IAC7C;;;;OAIG;IACH,UAAU,EAAE,CACV,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,SAAS,MAAM,EAAE,KACvB,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC;CACpD,CAAC,CAAC;AAEH,0DAA0D;AAC1D,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/B,CAAC,CAAC;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,UAChB,MAAM,GAAG,SAAS,uBAExB,MAglBF,CAAC"}