pr-report-core 0.2.1 → 0.3.0

package/README.md

@@ -57,8 +57,11 @@ assert.deepStrictEqual(cycles, [[12, 14]]);
   forest they describe, and everything read arranged into a report.
 - **`summarize.mts`** — the counts a report leads with.
 - **`ruleset.mts`** — what a ruleset requires: the contexts, and whether code
-  owners have to approve. **`code-owners.mts`**, **`review-hold.mts`** — who
-  owns a change, and whether a review holds a pull request.
+  owners have to approve. **`branch-rules.mts`** — the same read off GitHub for
+  a branch, its rulesets and a classic branch protection rule together, through
+  whatever transport the reader hands over. **`code-owners.mts`**,
+  **`review-hold.mts`** — who owns a change, and whether a review holds a pull
+  request.
 - **`queue-owner.mts`**, **`queue-order.mts`** — who moves each queued pull
   request next, and the order the queue picks them in.
 - **`set-aside.mts`**, **`claim.mts`** — the comments `unblock-prs` and a

package/dist/branch-rules.d.mts

@@ -0,0 +1,30 @@
+/**
+ * What GitHub enforces on a branch, read the one way every reader reads it:
+ * every ruleset that applies to the branch
+ * (`GET /repos/{owner}/{repo}/rules/branches/{branch}`), and the contexts a
+ * classic branch protection rule requires
+ * (`GET /repos/{owner}/{repo}/branches/{branch}`). Neither wants more than
+ * reading the repository, where the endpoints that list a ruleset's own
+ * settings or a protection rule's whole want an admin.
+ *
+ * What a classic rule says about reviews is not among what the second answers,
+ * so a code owner's approval is waited for only where a ruleset asks for it.
+ *
+ * Nothing here talks to GitHub: the reader hands over its own way of asking.
+ */
+import { Result } from 'ts-data-forge';
+import * as t from 'ts-fortress';
+import { type RulesetRequirements } from './ruleset.mjs';
+/**
+ * One `GET`, by the reader's own transport. `path` is relative to
+ * `/repos/{owner}/{repo}` and may carry a query string; `what` names the
+ * request for a message.
+ */
+export type BranchRulesGet = <A>(path: string, schema: t.Type<A>, what: string) => Promise<Result<A, string>>;
+/**
+ * The requirements on `branch`, or why they could not be read. Either request
+ * failing fails it: a list of required contexts missing half of them would be
+ * read as the whole.
+ */
+export declare const readBranchRequirements: (branch: string, get: BranchRulesGet) => Promise<Result<RulesetRequirements, string>>;
+//# sourceMappingURL=branch-rules.d.mts.map

package/dist/branch-rules.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-rules.d.mts","sourceRoot":"","sources":["../src/branch-rules.mts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAO,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AACjC,OAAO,EAAuB,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAE9E;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,EAC7B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EACjB,IAAI,EAAE,MAAM,KACT,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;AAEhC;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,WACzB,MAAM,OACT,cAAc,KAClB,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAAC,CA2C7C,CAAC"}

package/dist/branch-rules.mjs

@@ -0,0 +1,71 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+import { Arr, Result } from 'ts-data-forge';
+import * as t from 'ts-fortress';
+import { requirementsOfRules } from './ruleset.mjs';
+
+
+
+
+
+export const readBranchRequirements = async (branch, get) => {
+
+
+
+    const segment = encodeURIComponent(branch);
+    const [rules, branchAnswer] = await Promise.all([
+        get(`/rules/branches/${segment}?per_page=${RULES_PER_PAGE}`, RulesSchema, `the rules on ${branch}`),
+        get(`/branches/${segment}`, BranchSchema, `the protection of ${branch}`),
+    ]);
+    if (Result.isErr(rules)) {
+        return rules;
+    }
+    if (Result.isErr(branchAnswer)) {
+        return branchAnswer;
+    }
+    const fromRulesets = requirementsOfRules(rules.value);
+    const protection = branchAnswer.value.protection;
+    const classic = protection?.enabled === false
+        ? undefined
+        : protection?.required_status_checks;
+    return Result.ok({
+        ...fromRulesets,
+        requiredContexts: Arr.uniq([
+            ...fromRulesets.requiredContexts,
+
+
+            ...(classic === undefined || classic.enforcement_level === 'off'
+                ? []
+                : classic.contexts),
+        ]),
+    });
+};
+
+
+
+
+
+const RULES_PER_PAGE = 100;
+const RulesSchema = t.array(t.unknown());
+const BranchSchema = t.record({
+    protection: t.optional(t.record({
+        enabled: t.optional(t.boolean()),
+        required_status_checks: t.optional(t.record({
+            enforcement_level: t.optional(t.string()),
+            contexts: t.array(t.string()),
+        })),
+    })),
+});
+//# sourceMappingURL=branch-rules.mjs.map

package/dist/branch-rules.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-rules.mjs","sourceRoot":"","sources":["../src/branch-rules.mts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAA4B,MAAM,eAAe,CAAC;AAa9E;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,EACzC,MAAc,EACd,GAAmB,EAC2B,EAAE;IAChD,yEAAyE;IACzE,gEAAgE;IAChE,iDAAiD;IACjD,MAAM,OAAO,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAE3C,MAAM,CAAC,KAAK,EAAE,YAAY,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC9C,GAAG,CACD,mBAAmB,OAAO,aAAa,cAAc,EAAE,EACvD,WAAW,EACX,gBAAgB,MAAM,EAAE,CACzB;QACD,GAAG,CAAC,aAAa,OAAO,EAAE,EAAE,YAAY,EAAE,qBAAqB,MAAM,EAAE,CAAC;KACzE,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;QAC/B,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,MAAM,YAAY,GAAG,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEtD,MAAM,UAAU,GAAG,YAAY,CAAC,KAAK,CAAC,UAAU,CAAC;IAEjD,MAAM,OAAO,GACX,UAAU,EAAE,OAAO,KAAK,KAAK;QAC3B,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,UAAU,EAAE,sBAAsB,CAAC;IAEzC,OAAO,MAAM,CAAC,EAAE,CAAC;QACf,GAAG,YAAY;QACf,gBAAgB,EAAE,GAAG,CAAC,IAAI,CAAC;YACzB,GAAG,YAAY,CAAC,gBAAgB;YAChC,wEAAwE;YACxE,mCAAmC;YACnC,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,iBAAiB,KAAK,KAAK;gBAC9D,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;SACtB,CAAC;KACH,CAAC,CAAC;AACL,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,cAAc,GAAG,GAAG,CAAC;AAE3B,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AAEzC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,UAAU,EAAE,CAAC,CAAC,QAAQ,CACpB,CAAC,CAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QAChC,sBAAsB,EAAE,CAAC,CAAC,QAAQ,CAChC,CAAC,CAAC,MAAM,CAAC;YACP,iBAAiB,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;YACzC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SAC9B,CAAC,CACH;KACF,CAAC,CACH;CACF,CAAC,CAAC"}

package/dist/claim.d.mts

@@ -3,14 +3,15 @@
  * writer of the queue can read it.
  *
  * `unblock-prs` leaves a set-aside pull request alone until its head moves —
- * or, for every reason but `checks-failed` and `awaiting-bypass`, until the
- * base does, when it tries the rebase again. A session fixing that pull request
- * is then racing the script, and a second session, or the one that opened the
- * pull request and is woken by the set-aside comment, may be fixing the same
- * failure. The leases on every push keep any of them from overwriting another's
- * work, but not from doing it twice. So whoever starts on one says so first in
- * a comment whose first line is a hidden record this module writes and reads,
- * and everyone else — the script included — leaves that pull request to it.
+ * or, for every reason but `checks-failed`, `awaiting-bypass` and
+ * `head-out-of-sync`, until the base does, when it tries the rebase again. A
+ * session fixing that pull request is then racing the script, and a second
+ * session, or the one that opened the pull request and is woken by the
+ * set-aside comment, may be fixing the same failure. The leases on every push
+ * keep any of them from overwriting another's work, but not from doing it
+ * twice. So whoever starts on one says so first in a comment whose first line
+ * is a hidden record this module writes and reads, and everyone else — the
+ * script included — leaves that pull request to it.
  *
  * **It lasts while the head is the one it claimed**, and for at most
  * {@link CLAIM_LIFETIME_MINUTES}. The push that carries the fix moves the head
@@ -59,4 +60,10 @@ export declare const parseClaimComment: (body: string) => ClaimComment | undefin
  * `headTip`, at `nowEpochMs`.
  */
 export declare const claimApplies: (claim: Claim, headTip: string, nowEpochMs: number) => boolean;
+/**
+ * How far ahead of the reader's clock a claim may be dated and still count.
+ * Further than that is a clock that would otherwise stretch the lifetime by
+ * however far ahead it ran.
+ */
+export declare const CLOCK_SKEW_MINUTES = 5;
 //# sourceMappingURL=claim.d.mts.map

package/dist/claim.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"claim.d.mts","sourceRoot":"","sources":["../src/claim.mts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAIH,gEAAgE;AAChE,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C,MAAM,MAAM,KAAK,GAAG,QAAQ,CAAC;IAC3B,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,EAAE,EAAE,MAAM,CAAC;IACX,qEAAqE;IACrE,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,QAAQ,CACjC;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAC1D,CAAC;AAEF,sEAAsE;AACtE,eAAO,MAAM,UAAU,OAAQ,MAAM,KAAG,OAA4B,CAAC;AAErE,qCAAqC;AACrC,eAAO,MAAM,iBAAiB,UAAW,KAAK,SAAS,MAAM,KAAG,MAKlD,CAAC;AAEf,kEAAkE;AAClE,eAAO,MAAM,yBAAyB,UAAW,MAAM,KAAG,MACD,CAAC;AAE1D,qFAAqF;AACrF,eAAO,MAAM,iBAAiB,SAAU,MAAM,KAAG,YAAY,GAAG,SAsB/D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,UAChB,KAAK,WACH,MAAM,cACH,MAAM,KACjB,OASF,CAAC"}
+{"version":3,"file":"claim.d.mts","sourceRoot":"","sources":["../src/claim.mts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAIH,gEAAgE;AAChE,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C,MAAM,MAAM,KAAK,GAAG,QAAQ,CAAC;IAC3B,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,EAAE,EAAE,MAAM,CAAC;IACX,qEAAqE;IACrE,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,QAAQ,CACjC;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAC1D,CAAC;AAEF,sEAAsE;AACtE,eAAO,MAAM,UAAU,OAAQ,MAAM,KAAG,OAA4B,CAAC;AAErE,qCAAqC;AACrC,eAAO,MAAM,iBAAiB,UAAW,KAAK,SAAS,MAAM,KAAG,MAKlD,CAAC;AAEf,kEAAkE;AAClE,eAAO,MAAM,yBAAyB,UAAW,MAAM,KAAG,MACD,CAAC;AAE1D,qFAAqF;AACrF,eAAO,MAAM,iBAAiB,SAAU,MAAM,KAAG,YAAY,GAAG,SAsB/D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,UAChB,KAAK,WACH,MAAM,cACH,MAAM,KACjB,OASF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAC"}

package/dist/claim.mjs

@@ -25,6 +25,7 @@
 
 
 
+
 
 
 import { epochMsOf } from './timestamp.mjs';
@@ -73,7 +74,7 @@ export const claimApplies = (claim, headTip, nowEpochMs) => {
 
 
 
-const CLOCK_SKEW_MINUTES = 5;
+export const CLOCK_SKEW_MINUTES = 5;
 const MS_PER_MINUTE = 60_000;
 
 const MARKER = '<!-- unblock-prs:claim';

package/dist/claim.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"claim.mjs","sourceRoot":"","sources":["../src/claim.mts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,gEAAgE;AAChE,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAkB1C,sEAAsE;AACtE,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,EAAU,EAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAErE,qCAAqC;AACrC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAY,EAAE,KAAa,EAAU,EAAE,CACvE;IACE,GAAG,MAAM,SAAS,KAAK,CAAC,OAAO,OAAO,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC,EAAE,MAAM;IACnE,EAAE;IACF,KAAK,CAAC,IAAI,EAAE;CACb,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEf,kEAAkE;AAClE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,KAAa,EAAU,EAAE,CACjE,CAAC,GAAG,MAAM,eAAe,EAAE,EAAE,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAE1D,qFAAqF;AACrF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAA4B,EAAE;IAC1E,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;IAExD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,KAAK,KAAK,GAAG,MAAM,eAAe,EAAE,CAAC;QACvC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAC9B,CAAC;IAED,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEjD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC;IAEpC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;IAE1B,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;IAE1B,OAAO,OAAO,KAAK,SAAS,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,SAAS;QAClE,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;AACvD,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,KAAY,EACZ,OAAe,EACf,UAAkB,EACT,EAAE;IACX,MAAM,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAE/B,OAAO,CACL,KAAK,CAAC,OAAO,KAAK,OAAO;QACzB,EAAE,KAAK,SAAS;QAChB,EAAE,GAAG,kBAAkB,GAAG,aAAa,IAAI,UAAU;QACrD,UAAU,GAAG,EAAE,GAAG,sBAAsB,GAAG,aAAa,CACzD,CAAC;AACJ,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAE7B,MAAM,aAAa,GAAG,MAAM,CAAC;AAE7B,sEAAsE;AACtE,MAAM,MAAM,GAAG,wBAAwB,CAAC;AAExC,qFAAqF;AACrF,MAAM,QAAQ,GAAG,YAAY,CAAC;AAE9B,MAAM,aAAa,GACjB,8HAA8H,CAAC"}
+{"version":3,"file":"claim.mjs","sourceRoot":"","sources":["../src/claim.mts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,gEAAgE;AAChE,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAkB1C,sEAAsE;AACtE,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,EAAU,EAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAErE,qCAAqC;AACrC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAY,EAAE,KAAa,EAAU,EAAE,CACvE;IACE,GAAG,MAAM,SAAS,KAAK,CAAC,OAAO,OAAO,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC,EAAE,MAAM;IACnE,EAAE;IACF,KAAK,CAAC,IAAI,EAAE;CACb,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEf,kEAAkE;AAClE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,KAAa,EAAU,EAAE,CACjE,CAAC,GAAG,MAAM,eAAe,EAAE,EAAE,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAE1D,qFAAqF;AACrF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAA4B,EAAE;IAC1E,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;IAExD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,KAAK,KAAK,GAAG,MAAM,eAAe,EAAE,CAAC;QACvC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAC9B,CAAC;IAED,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEjD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC;IAEpC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;IAE1B,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;IAE1B,OAAO,OAAO,KAAK,SAAS,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,SAAS;QAClE,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;AACvD,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,KAAY,EACZ,OAAe,EACf,UAAkB,EACT,EAAE;IACX,MAAM,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAE/B,OAAO,CACL,KAAK,CAAC,OAAO,KAAK,OAAO;QACzB,EAAE,KAAK,SAAS;QAChB,EAAE,GAAG,kBAAkB,GAAG,aAAa,IAAI,UAAU;QACrD,UAAU,GAAG,EAAE,GAAG,sBAAsB,GAAG,aAAa,CACzD,CAAC;AACJ,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAEpC,MAAM,aAAa,GAAG,MAAM,CAAC;AAE7B,sEAAsE;AACtE,MAAM,MAAM,GAAG,wBAAwB,CAAC;AAExC,qFAAqF;AACrF,MAAM,QAAQ,GAAG,YAAY,CAAC;AAE9B,MAAM,aAAa,GACjB,8HAA8H,CAAC"}

package/dist/index.d.mts

@@ -1,7 +1,10 @@
+export * from './branch-rules.mjs';
 export * from './checks.mjs';
 export * from './claim.mjs';
 export * from './closing-issues.mjs';
 export * from './code-owners.mjs';
+export * from './issue-claim.mjs';
+export * from './issue-priority.mjs';
 export * from './labels.mjs';
 export * from './merge-after.mjs';
 export * from './queue-comments.mjs';

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.mts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.mts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/dist/index.mjs

@@ -1,7 +1,10 @@
+export * from './branch-rules.mjs';
 export * from './checks.mjs';
 export * from './claim.mjs';
 export * from './closing-issues.mjs';
 export * from './code-owners.mjs';
+export * from './issue-claim.mjs';
+export * from './issue-priority.mjs';
 export * from './labels.mjs';
 export * from './merge-after.mjs';
 export * from './queue-comments.mjs';

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.mts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.mts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/dist/issue-claim.d.mts

@@ -0,0 +1,56 @@
+/**
+ * Who has started an issue, or means to, written where every session can read
+ * it.
+ *
+ * The `in-progress` and `planned` labels (`labels.mts`) say that someone is on
+ * an issue, not who: every session writes as the same account, so neither the
+ * labels nor the assignees tell two of them apart, and a session refused by a
+ * label cannot say whose it is. So `start-issue` also writes a comment whose
+ * first line is a hidden record this module writes and reads, naming the
+ * claimant (a session URL, or any other word unique to it; `claim.mts`'s
+ * `isClaimant`).
+ *
+ * **A start lasts until it is released**, as the label always has: the pull
+ * request that closes the issue is what ends it. **A plan lapses** after
+ * {@link PLANNED_CLAIM_LIFETIME_HOURS}, since it holds nothing back and a
+ * session that meant to start next may never get there; a claimant still
+ * meaning to writes it again.
+ *
+ * **One comment per issue, edited in place**, as for the pull request claim; of
+ * several, the oldest is the one, so two claimants writing at once both read
+ * back the same answer — which a label cannot give, having no order to read.
+ *
+ * **Only the comments the reader's own account wrote count**: the repository is
+ * public.
+ */
+import type { OwnComment, QueueComment } from './queue-comments.mjs';
+/** How long a plan lasts when it is not written again. */
+export declare const PLANNED_CLAIM_LIFETIME_HOURS = 24;
+export type IssueClaim = Readonly<{
+    /** Started (`in-progress`) or meant to be started next (`planned`). */
+    state: 'planned' | 'started';
+    /** Who claimed it: a session URL, or any other word unique to the claimant. */
+    by: string;
+    /** When, as a UTC instant to the second (`2026-10-12T01:00:00Z`). */
+    at: string;
+}>;
+export type IssueClaimComment = Readonly<{
+    kind: 'released';
+} | {
+    kind: 'standing';
+    claim: IssueClaim;
+}>;
+/** The record line, then `prose`. */
+export declare const writeIssueClaimComment: (claim: IssueClaim, prose: string) => string;
+/** The record line saying the claim was given up, and `prose`. */
+export declare const writeReleasedIssueClaimComment: (prose: string) => string;
+/** What the comment says, or `undefined` for a comment this module did not write. */
+export declare const parseIssueClaimComment: (body: string) => IssueClaimComment | undefined;
+/** Whether `claim` still holds the issue at `nowEpochMs`. */
+export declare const issueClaimApplies: (claim: IssueClaim, nowEpochMs: number) => boolean;
+/**
+ * Reads `comments`, oldest first, for the oldest claim comment, and whether it
+ * still holds; `undefined` when there is none.
+ */
+export declare const readIssueClaim: (comments: readonly OwnComment[], nowEpochMs: number) => QueueComment<IssueClaimComment> | undefined;
+//# sourceMappingURL=issue-claim.d.mts.map

package/dist/issue-claim.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-claim.d.mts","sourceRoot":"","sources":["../src/issue-claim.mts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGrE,0DAA0D;AAC1D,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAE/C,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAChC,uEAAuE;IACvE,KAAK,EAAE,SAAS,GAAG,SAAS,CAAC;IAC7B,+EAA+E;IAC/E,EAAE,EAAE,MAAM,CAAC;IACX,qEAAqE;IACrE,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CACtC;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,CAC/D,CAAC;AAEF,qCAAqC;AACrC,eAAO,MAAM,sBAAsB,UAC1B,UAAU,SACV,MAAM,KACZ,MAKW,CAAC;AAEf,kEAAkE;AAClE,eAAO,MAAM,8BAA8B,UAAW,MAAM,KAAG,MACN,CAAC;AAE1D,qFAAqF;AACrF,eAAO,MAAM,sBAAsB,SAC3B,MAAM,KACX,iBAAiB,GAAG,SAwBtB,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,iBAAiB,UACrB,UAAU,cACL,MAAM,KACjB,OASF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,aACf,SAAS,UAAU,EAAE,cACnB,MAAM,KACjB,YAAY,CAAC,iBAAiB,CAAC,GAAG,SAepC,CAAC"}

package/dist/issue-claim.mjs

@@ -0,0 +1,87 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+import { CLOCK_SKEW_MINUTES } from './claim.mjs';
+import { epochMsOf } from './timestamp.mjs';
+
+export const PLANNED_CLAIM_LIFETIME_HOURS = 24;
+
+export const writeIssueClaimComment = (claim, prose) => [
+    `${MARKER} state=${claim.state} by=${claim.by} at=${claim.at} -->`,
+    '',
+    prose.trim(),
+].join('\n');
+
+export const writeReleasedIssueClaimComment = (prose) => [`${MARKER} released -->`, '', prose.trim()].join('\n');
+
+export const parseIssueClaimComment = (body) => {
+    const first = body.trim().split(/\r?\n/u, 1)[0]?.trim();
+    if (first === undefined) {
+        return undefined;
+    }
+    if (first === `${MARKER} released -->`) {
+        return { kind: 'released' };
+    }
+    const groups = STANDING_LINE.exec(first)?.groups;
+    const state = groups?.['state'];
+    const by = groups?.['by'];
+    const at = groups?.['at'];
+    return by === undefined ||
+        at === undefined ||
+        (state !== 'planned' && state !== 'started')
+        ? undefined
+        : { kind: 'standing', claim: { state, by, at } };
+};
+
+export const issueClaimApplies = (claim, nowEpochMs) => {
+    const at = epochMsOf(claim.at);
+    return (at !== undefined &&
+        at - CLOCK_SKEW_MINUTES * MS_PER_MINUTE <= nowEpochMs &&
+        (claim.state === 'started' ||
+            nowEpochMs < at + PLANNED_CLAIM_LIFETIME_HOURS * MS_PER_HOUR));
+};
+
+
+
+
+export const readIssueClaim = (comments, nowEpochMs) => {
+    for (const { id, body } of comments) {
+        const says = parseIssueClaimComment(body);
+        if (says !== undefined) {
+            return {
+                commentId: id,
+                says,
+                applies: says.kind === 'standing' && issueClaimApplies(says.claim, nowEpochMs),
+            };
+        }
+    }
+    return undefined;
+};
+const MS_PER_MINUTE = 60_000;
+const MS_PER_HOUR = 60 * MS_PER_MINUTE;
+
+const MARKER = '<!-- start-issue:claim';
+const STANDING_LINE = /^<!-- start-issue:claim state=(?<state>planned|started) by=(?<by>[^\s>]+) at=(?<at>\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z) -->$/u;
+//# sourceMappingURL=issue-claim.mjs.map

package/dist/issue-claim.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-claim.mjs","sourceRoot":"","sources":["../src/issue-claim.mts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,0DAA0D;AAC1D,MAAM,CAAC,MAAM,4BAA4B,GAAG,EAAE,CAAC;AAe/C,qCAAqC;AACrC,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,KAAiB,EACjB,KAAa,EACL,EAAE,CACV;IACE,GAAG,MAAM,UAAU,KAAK,CAAC,KAAK,OAAO,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC,EAAE,MAAM;IAClE,EAAE;IACF,KAAK,CAAC,IAAI,EAAE;CACb,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEf,kEAAkE;AAClE,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,KAAa,EAAU,EAAE,CACtE,CAAC,GAAG,MAAM,eAAe,EAAE,EAAE,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAE1D,qFAAqF;AACrF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,IAAY,EACmB,EAAE;IACjC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;IAExD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,KAAK,KAAK,GAAG,MAAM,eAAe,EAAE,CAAC;QACvC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAC9B,CAAC;IAED,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEjD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC;IAEhC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;IAE1B,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;IAE1B,OAAO,EAAE,KAAK,SAAS;QACrB,EAAE,KAAK,SAAS;QAChB,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,CAAC;QAC5C,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;AACrD,CAAC,CAAC;AAEF,6DAA6D;AAC7D,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,KAAiB,EACjB,UAAkB,EACT,EAAE;IACX,MAAM,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAE/B,OAAO,CACL,EAAE,KAAK,SAAS;QAChB,EAAE,GAAG,kBAAkB,GAAG,aAAa,IAAI,UAAU;QACrD,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS;YACxB,UAAU,GAAG,EAAE,GAAG,4BAA4B,GAAG,WAAW,CAAC,CAChE,CAAC;AACJ,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,QAA+B,EAC/B,UAAkB,EAC2B,EAAE;IAC/C,KAAK,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,QAAQ,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;QAE1C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO;gBACL,SAAS,EAAE,EAAE;gBACb,IAAI;gBACJ,OAAO,EACL,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,iBAAiB,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC;aACxE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,MAAM,CAAC;AAE7B,MAAM,WAAW,GAAG,EAAE,GAAG,aAAa,CAAC;AAEvC,sEAAsE;AACtE,MAAM,MAAM,GAAG,wBAAwB,CAAC;AAExC,MAAM,aAAa,GACjB,gIAAgI,CAAC"}

package/dist/issue-priority.d.mts

@@ -0,0 +1,44 @@
+/**
+ * How soon an open issue should be started: one `priority:<tier>` label each,
+ * decided when the issue is filed. What each tier means, and how an issue is
+ * placed in one, is `docs/issue-priority.md`.
+ *
+ * These are issue labels. A pull request's place in the merge queue is
+ * `priority:high` / `priority:low` (`labels.mts`), which no issue carries.
+ */
+/** The tier the one `priority:<tier>` label names, `none`, or `several`. */
+export declare const issuePriorityOfLabels: (labels: readonly string[]) => IssuePriority | 'none' | 'several';
+/**
+ * Where an issue goes in the order it is started in, as a sort key: `S` first,
+ * then `A`, `B` and `C`, then one with no tier or several, then `D`. What
+ * nobody has placed is not known to matter less than what was placed last.
+ * `hold` and `close` rank with no tier here; whoever takes issues in this order
+ * leaves them out first.
+ */
+export declare const issueStartRank: (labels: readonly string[]) => number;
+/** The tier as written on a command line, or `undefined` for anything else. */
+export declare const parseIssuePriority: (raw: string) => IssuePriority | undefined;
+export declare const issuePriorityLabel: (priority: IssuePriority) => `priority:${IssuePriority}`;
+/**
+ * Every tier, the order `docs/issue-priority.md` lists them in.
+ *
+ * - `S` — speeds up the work on everything else now: CI, `check-changed`, the
+ *   merge queue, the review loop, a step a person does by hand most days.
+ * - `A` — what the rest of that stands on, a step a person does by hand on
+ *   every release or deploy, a security issue, or a bug real users meet that
+ *   stops what they came to do.
+ * - `B` — the other bugs in an app with users or in a published package, and
+ *   smaller gains in speed.
+ * - `C` — documents, refactoring, small improvements and features.
+ * - `D` — an app nobody uses but its author, and large features.
+ * - `hold` — not to be started as things stand: code about to be replaced, or
+ *   work waiting on a decision.
+ * - `close` — to be closed or folded into another issue at the next triage.
+ *
+ * `pr-manager`'s tier tooltips (`issue-tier-group.tsx`) repeat this list.
+ */
+export declare const ISSUE_PRIORITIES: readonly ['S', 'A', 'B', 'C', 'D', 'hold', 'close'];
+export type IssuePriority = (typeof ISSUE_PRIORITIES)[number];
+/** The tiers a new issue may be filed under: `close` is a verdict on one. */
+export declare const FILING_PRIORITIES: readonly ["S", "A", "B", "C", "D", "hold"];
+//# sourceMappingURL=issue-priority.d.mts.map

package/dist/issue-priority.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-priority.d.mts","sourceRoot":"","sources":["../src/issue-priority.mts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,4EAA4E;AAC5E,eAAO,MAAM,qBAAqB,WACxB,SAAS,MAAM,EAAE,KACxB,aAAa,GAAG,MAAM,GAAG,SAe3B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,WAAY,SAAS,MAAM,EAAE,KAAG,MAM1D,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,kBAAkB,QAAS,MAAM,KAAG,aAAa,GAAG,SACV,CAAC;AAExD,eAAO,MAAM,kBAAkB,aACnB,aAAa,KACtB,YAAY,aAAa,EAAqC,CAAC;AAElE;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,gBAAgB,YAC3B,GAAG,EACH,GAAG,EACH,GAAG,EACH,GAAG,EACH,GAAG,EACH,MAAM,EACN,OAAO,CACC,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,6EAA6E;AAC7E,eAAO,MAAM,iBAAiB,4CAOe,CAAC"}

package/dist/issue-priority.mjs

@@ -0,0 +1,91 @@
+
+
+
+
+
+
+
+
+
+export const issuePriorityOfLabels = (labels) => {
+    const carried = ISSUE_PRIORITIES.filter((priority) => labels.includes(issuePriorityLabel(priority)));
+    switch (carried.length) {
+        case 0:
+            return 'none';
+        case 1:
+            return carried[0] ?? 'none';
+        default:
+            return 'several';
+    }
+};
+
+
+
+
+
+
+
+export const issueStartRank = (labels) => {
+    const priority = issuePriorityOfLabels(labels);
+    return priority === 'none' || priority === 'several'
+        ? UNPLACED_RANK
+        : rankOf(priority);
+};
+
+export const parseIssuePriority = (raw) => ISSUE_PRIORITIES.find((priority) => priority === raw);
+export const issuePriorityLabel = (priority) => `priority:${priority}`;
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+export const ISSUE_PRIORITIES = [
+    'S',
+    'A',
+    'B',
+    'C',
+    'D',
+    'hold',
+    'close',
+];
+
+export const FILING_PRIORITIES = [
+    'S',
+    'A',
+    'B',
+    'C',
+    'D',
+    'hold',
+];
+const UNPLACED_RANK = 4;
+const rankOf = (priority) => {
+    switch (priority) {
+        case 'S':
+            return 0;
+        case 'A':
+            return 1;
+        case 'B':
+            return 2;
+        case 'C':
+            return 3;
+        case 'D':
+            return 5;
+        case 'hold':
+        case 'close':
+            return UNPLACED_RANK;
+    }
+};
+//# sourceMappingURL=issue-priority.mjs.map

package/dist/issue-priority.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-priority.mjs","sourceRoot":"","sources":["../src/issue-priority.mts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,4EAA4E;AAC5E,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,MAAyB,EACW,EAAE;IACtC,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CACnD,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAC9C,CAAC;IAEF,QAAQ,OAAO,CAAC,MAAM,EAAE,CAAC;QACvB,KAAK,CAAC;YACJ,OAAO,MAAM,CAAC;QAEhB,KAAK,CAAC;YACJ,OAAO,OAAO,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;QAE9B;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAyB,EAAU,EAAE;IAClE,MAAM,QAAQ,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAE/C,OAAO,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,SAAS;QAClD,CAAC,CAAC,aAAa;QACf,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACvB,CAAC,CAAC;AAEF,+EAA+E;AAC/E,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,GAAW,EAA6B,EAAE,CAC3E,gBAAgB,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,KAAK,GAAG,CAAC,CAAC;AAExD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,QAAuB,EACM,EAAE,CAAC,YAAY,QAAQ,EAAW,CAAC;AAElE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,MAAM;IACN,OAAO;CACC,CAAC;AAIX,6EAA6E;AAC7E,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,MAAM;CACqC,CAAC;AAE9C,MAAM,aAAa,GAAG,CAAC,CAAC;AAExB,MAAM,MAAM,GAAG,CAAC,QAAuB,EAAU,EAAE;IACjD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,GAAG;YACN,OAAO,CAAC,CAAC;QAEX,KAAK,GAAG;YACN,OAAO,CAAC,CAAC;QAEX,KAAK,GAAG;YACN,OAAO,CAAC,CAAC;QAEX,KAAK,GAAG;YACN,OAAO,CAAC,CAAC;QAEX,KAAK,GAAG;YACN,OAAO,CAAC,CAAC;QAEX,KAAK,MAAM,CAAC;QACZ,KAAK,OAAO;YACV,OAAO,aAAa,CAAC;IACzB,CAAC;AACH,CAAC,CAAC"}

package/dist/labels.d.mts

@@ -50,7 +50,8 @@ export declare const AUTO_REBASE_LABEL = "auto-rebase";
  * labelled `priority:low` last, the version pull request included.
  * They decide nothing else — what `Merge-After:`, a stack or `blocks-release`
  * holds back stays held, and a pull request already in flight is watched
- * whatever it carries. One carrying both counts as neither.
+ * whatever it carries. One carrying both counts as neither. They are pull
+ * request labels: an issue's is a tier (`issue-priority.mts`).
  * {@link PRIORITY_MID_LABEL} is not read there: it is the same as carrying
  * neither.
  */
@@ -70,8 +71,9 @@ export declare const PRIORITY_MID_LABEL = "priority:mid";
 export declare const PENDING_LABEL = "pending";
 /**
  * The label that says someone has started an issue, before there is a pull
- * request to say so. `start-issue` puts it on, and refuses an issue that
- * already carries it, so that two sessions do not pick up the same one; the
+ * request to say so. `start-issue` puts it on, with a claim comment saying who
+ * (`issue-claim.mts`), and refuses an issue someone else claimed or that
+ * carries it unclaimed, so that two sessions do not pick up the same one; the
  * Pull Requests Manager page and `pr-report` show a startable issue carrying it
  * as in progress, as they show one an open pull request closes
  * (`start-after.mts`'s `progressOf`). Nothing takes it off when the work
@@ -82,6 +84,7 @@ export declare const IN_PROGRESS_LABEL = "in-progress";
  * The label that says someone means to start an issue next. It holds nothing
  * back — `start-issue` takes it off as it puts {@link IN_PROGRESS_LABEL} on —
  * and only tells whoever is choosing what to start that this one is spoken for;
+ * `start-issue --plan` puts it on with a claim comment saying by whom;
  * the page and `pr-report` show a startable issue carrying it as planned.
  */
 export declare const PLANNED_LABEL = "planned";

package/dist/labels.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"labels.d.mts","sourceRoot":"","sources":["../src/labels.mts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,aAAa,YAAY,CAAC;AAEvC;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,iBAAiB,CAAC;AAEjD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,oBAAoB,mBAAmB,CAAC;AAErD;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,gBAAgB,CAAC;AAE/C;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,kBAAkB,CAAC;AAEnD,eAAO,MAAM,kBAAkB,iBAAiB,CAAC;AAEjD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,iBAAiB,CAAC;AAEjD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,YAAY,CAAC;AAEvC;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,gBAAgB,CAAC;AAE/C;;;;;GAKG;AACH,eAAO,MAAM,aAAa,YAAY,CAAC"}
+{"version":3,"file":"labels.d.mts","sourceRoot":"","sources":["../src/labels.mts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,aAAa,YAAY,CAAC;AAEvC;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,iBAAiB,CAAC;AAEjD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,oBAAoB,mBAAmB,CAAC;AAErD;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,gBAAgB,CAAC;AAE/C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,kBAAkB,CAAC;AAEnD,eAAO,MAAM,kBAAkB,iBAAiB,CAAC;AAEjD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,iBAAiB,CAAC;AAEjD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,YAAY,CAAC;AAEvC;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,gBAAgB,CAAC;AAE/C;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,YAAY,CAAC"}

package/dist/labels.mjs

@@ -54,6 +54,7 @@ export const AUTO_REBASE_LABEL = 'auto-rebase';
 
 
 
+
 export const PRIORITY_HIGH_LABEL = 'priority:high';
 export const PRIORITY_LOW_LABEL = 'priority:low';
 
@@ -77,6 +78,7 @@ export const PENDING_LABEL = 'pending';
 
 
 
+
 export const IN_PROGRESS_LABEL = 'in-progress';
 
 
@@ -84,5 +86,6 @@ export const IN_PROGRESS_LABEL = 'in-progress';
 
 
 
+
 export const PLANNED_LABEL = 'planned';
 //# sourceMappingURL=labels.mjs.map

package/dist/labels.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"labels.mjs","sourceRoot":"","sources":["../src/labels.mts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,SAAS,CAAC;AAEvC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,cAAc,CAAC;AAEjD;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,gBAAgB,CAAC;AAErD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAC;AAE/C;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,eAAe,CAAC;AAEnD,MAAM,CAAC,MAAM,kBAAkB,GAAG,cAAc,CAAC;AAEjD;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,cAAc,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,SAAS,CAAC;AAEvC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,SAAS,CAAC"}
+{"version":3,"file":"labels.mjs","sourceRoot":"","sources":["../src/labels.mts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,SAAS,CAAC;AAEvC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,cAAc,CAAC;AAEjD;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,gBAAgB,CAAC;AAErD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAC;AAE/C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,eAAe,CAAC;AAEnD,MAAM,CAAC,MAAM,kBAAkB,GAAG,cAAc,CAAC;AAEjD;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,cAAc,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,SAAS,CAAC;AAEvC;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,SAAS,CAAC"}

package/dist/queue-owner.d.mts

@@ -39,7 +39,7 @@ export type QueueOwner = Readonly<{
     reason: string;
 }>;
 /** Every reason the worker writes into a set-aside comment. */
-export declare const SET_ASIDE_REASONS: readonly ['already-in-base', 'arm-failed', 'awaiting-bypass', 'checks-failed', 'not-merging', 'push-failed', 'rebase-failed', 'unlabel-failed', 'watch-timeout'];
+export declare const SET_ASIDE_REASONS: readonly ['already-in-base', 'arm-failed', 'awaiting-bypass', 'checks-failed', 'checks-not-started', 'head-out-of-sync', 'not-merging', 'push-failed', 'read-failed', 'rebase-failed', 'unlabel-failed', 'watch-timeout'];
 export type SetAsideReason = (typeof SET_ASIDE_REASONS)[number];
 /**
  * Who moves `pr` next, or `undefined` for a pull request the queue does not

package/dist/queue-owner.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"queue-owner.d.mts","sourceRoot":"","sources":["../src/queue-owner.mts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAM9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAY,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,eAAO,MAAM,YAAY,YAAI,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAU,CAAC;AAE1E;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAChC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC7C,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAAC;AAEH,+DAA+D;AAC/D,eAAO,MAAM,iBAAiB,YAC5B,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,eAAe,CACP,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE;;;GAGG;AACH,eAAO,MAAM,UAAU,OAAQ,eAAe,KAAG,UAAU,GAAG,SAoE7D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,UACrB,WAAW,YACR,aAAa,WACd,QAAQ,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC,KACD,UAAU,GAAG,SAeZ,CAAC;AAEL,eAAO,MAAM,gBAAgB,WAAY,MAAM,KAAG,MAAM,IAAI,cACjC,CAAC;AA8D5B,4DAA4D;AAC5D,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,gEAAgE;IAChE,QAAQ,EAAE,eAAe,GAAG,SAAS,CAAC;IACtC,wDAAwD;IACxD,KAAK,EAAE,YAAY,GAAG,SAAS,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC,CAAC"}
+{"version":3,"file":"queue-owner.d.mts","sourceRoot":"","sources":["../src/queue-owner.mts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAM9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAY,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,eAAO,MAAM,YAAY,YAAI,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAU,CAAC;AAE1E;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAChC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC7C,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAAC;AAEH,+DAA+D;AAC/D,eAAO,MAAM,iBAAiB,YAC5B,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,eAAe,CACP,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE;;;GAGG;AACH,eAAO,MAAM,UAAU,OAAQ,eAAe,KAAG,UAAU,GAAG,SAoE7D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,UACrB,WAAW,YACR,aAAa,WACd,QAAQ,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC,KACD,UAAU,GAAG,SAeZ,CAAC;AAEL,eAAO,MAAM,gBAAgB,WAAY,MAAM,KAAG,MAAM,IAAI,cACjC,CAAC;AAgF5B,4DAA4D;AAC5D,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,gEAAgE;IAChE,QAAQ,EAAE,eAAe,GAAG,SAAS,CAAC;IACtC,wDAAwD;IACxD,KAAK,EAAE,YAAY,GAAG,SAAS,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC,CAAC"}