@svp-labs/talos 0.0.0 → 0.1.1

package/dist/ticket/schemas.js

@@ -0,0 +1,106 @@
+import { z } from 'zod';
+/**
+ * The parts of GitHub's REST responses the claim protocol and the jobs rely on, validated before
+ * use. Unknown fields are dropped; a missing one is an error, never a guess.
+ */
+const user = z.object({ login: z.string(), type: z.string().optional() }).nullable().optional();
+const label = z.union([z.string(), z.object({ name: z.string() })]);
+const rawIssue = z.object({
+    number: z.number().int().positive(),
+    title: z.string(),
+    body: z.string().nullable().optional(),
+    state: z.enum(['open', 'closed']),
+    state_reason: z.string().nullable().optional(),
+    labels: z.array(label),
+    user,
+    author_association: z.string().optional(),
+    created_at: z.string(),
+    closed_at: z.string().nullable().optional(),
+    pull_request: z.unknown().optional(),
+});
+function toIssue(raw) {
+    return {
+        number: raw.number,
+        title: raw.title,
+        body: raw.body ?? '',
+        state: raw.state,
+        stateReason: raw.state_reason ?? undefined,
+        labels: raw.labels.map((l) => (typeof l === 'string' ? l : l.name)),
+        author: raw.user?.login,
+        association: raw.author_association,
+        createdAt: raw.created_at,
+        closedAt: raw.closed_at ?? undefined,
+        isPull: raw.pull_request !== undefined && raw.pull_request !== null,
+    };
+}
+export function parseIssue(data) {
+    return toIssue(rawIssue.parse(data));
+}
+export function parseIssues(data) {
+    return z.array(rawIssue).parse(data).map(toIssue);
+}
+const rawComment = z.object({
+    id: z.number().int(),
+    body: z.string().nullable().optional(),
+    user,
+    author_association: z.string().optional(),
+    created_at: z.string(),
+});
+export function parseComments(data) {
+    return z
+        .array(rawComment)
+        .parse(data)
+        .map((c) => ({
+        id: c.id,
+        body: c.body ?? '',
+        author: c.user?.login,
+        association: c.author_association,
+        createdAt: c.created_at,
+    }));
+}
+export const refSchema = z.object({ ref: z.string(), object: z.object({ sha: z.string() }) });
+export const repoSchema = z.object({ default_branch: z.string().min(1) });
+export const branchSchema = z.object({
+    commit: z.object({
+        sha: z.string(),
+        commit: z.object({
+            committer: z.object({ date: z.string().optional() }).nullable().optional(),
+        }),
+    }),
+});
+const rawPull = z.object({
+    number: z.number().int().positive(),
+    draft: z.boolean().optional(),
+    state: z.enum(['open', 'closed']),
+    updated_at: z.string(),
+    head: z.object({ ref: z.string() }),
+});
+export function parsePulls(data) {
+    return z
+        .array(rawPull)
+        .parse(data)
+        .map((p) => ({
+        number: p.number,
+        draft: p.draft ?? false,
+        state: p.state,
+        updatedAt: p.updated_at,
+        headRef: p.head.ref,
+    }));
+}
+/** Timeline items differ by kind; only `labeled` events are read. */
+export const timelineSchema = z.array(z.object({
+    event: z.string().optional(),
+    created_at: z.string().optional(),
+    label: z.object({ name: z.string() }).optional(),
+}));
+export const contentsFileSchema = z.object({
+    type: z.literal('file'),
+    encoding: z.literal('base64'),
+    content: z.string(),
+});
+export const labelListSchema = z.array(z.object({
+    name: z.string(),
+    color: z.string(),
+    description: z.string().nullable().optional(),
+}));
+//# sourceMappingURL=schemas.js.map

package/dist/ticket/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/ticket/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AAEH,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC;AAEhG,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;AAEpE,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;IACxB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACnC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACtC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACjC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC9C,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;IACtB,IAAI;IACJ,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC3C,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC;AAiBH,SAAS,OAAO,CAAC,GAA6B;IAC5C,OAAO;QACL,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE;QACpB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,WAAW,EAAE,GAAG,CAAC,YAAY,IAAI,SAAS;QAC1C,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACnE,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,KAAK;QACvB,WAAW,EAAE,GAAG,CAAC,kBAAkB;QACnC,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,QAAQ,EAAE,GAAG,CAAC,SAAS,IAAI,SAAS;QACpC,MAAM,EAAE,GAAG,CAAC,YAAY,KAAK,SAAS,IAAI,GAAG,CAAC,YAAY,KAAK,IAAI;KACpE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAa;IACtC,OAAO,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAa;IACvC,OAAO,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACtC,IAAI;IACJ,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;CACvB,CAAC,CAAC;AAUH,MAAM,UAAU,aAAa,CAAC,IAAa;IACzC,OAAO,CAAC;SACL,KAAK,CAAC,UAAU,CAAC;SACjB,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACX,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,EAAE;QAClB,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK;QACrB,WAAW,EAAE,CAAC,CAAC,kBAAkB;QACjC,SAAS,EAAE,CAAC,CAAC,UAAU;KACxB,CAAC,CAAC,CAAC;AACR,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;AAE9F,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAE1E,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;QACf,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;YACf,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;SAC3E,CAAC;KACH,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC;IACvB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACnC,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC7B,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACjC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;CACpC,CAAC,CAAC;AAUH,MAAM,UAAU,UAAU,CAAC,IAAa;IACtC,OAAO,CAAC;SACL,KAAK,CAAC,OAAO,CAAC;SACd,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACX,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,KAAK;QACvB,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,SAAS,EAAE,CAAC,CAAC,UAAU;QACvB,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG;KACpB,CAAC,CAAC,CAAC;AACR,CAAC;AAED,qEAAqE;AACrE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CACnC,CAAC,CAAC,MAAM,CAAC;IACP,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE;CACjD,CAAC,CACH,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IACvB,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CACpC,CAAC,CAAC,MAAM,CAAC;IACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC9C,CAAC,CACH,CAAC"}

package/dist/ticket/sections.js

@@ -0,0 +1,66 @@
+/**
+ * An issue body's `##` sections, as the issue forms write them (`### Goal`) or a person types
+ * them. Headings are matched without case, trailing colons or spacing around a slash, so
+ * "Expected / Actual" and "expected/actual:" are the same section.
+ */
+const HEADING = /^#{2,6}[ \t]+(\S.*)$/;
+const CHECKBOX = /^[ \t]*[-*+] \[[ xX]\] \S/;
+const NO_RESPONSE = '_No response_';
+export function sectionKey(heading) {
+    return heading
+        .trim()
+        .toLowerCase()
+        .replace(/:$/, '')
+        .split('/')
+        .map((part) => part.trim().replaceAll(/\s+/g, ' '))
+        .join('/');
+}
+/** Each section's text by its key; the first of two sections with one key wins. */
+export function sections(body) {
+    const found = new Map();
+    let key;
+    let lines = [];
+    const close = () => {
+        if (key !== undefined && !found.has(key))
+            found.set(key, lines.join('\n').trim());
+    };
+    for (const line of body.split(/\r?\n/)) {
+        const heading = HEADING.exec(line)?.[1];
+        if (heading === undefined) {
+            lines.push(line);
+            continue;
+        }
+        close();
+        key = sectionKey(heading);
+        lines = [];
+    }
+    close();
+    return found;
+}
+/** Whether a section says something: issue forms write `_No response_` for an empty field. */
+export function hasContent(text) {
+    if (text === undefined)
+        return false;
+    const trimmed = text.trim();
+    return trimmed !== '' && trimmed !== NO_RESPONSE;
+}
+export function checkboxCount(text) {
+    return text.split(/\r?\n/).filter((line) => CHECKBOX.test(line)).length;
+}
+const LISTED_PATH = /^[ \t]*[-*+][ \t]+`([^`\s]+)`[ \t]*$/;
+/**
+ * The paths an `Affected areas` section lists, one per item as `` - `path` ``: the form Talos
+ * writes for its own debt issues and sync chores, which the review reads to decide whether a
+ * diff stays inside its issue. Items in other words name no path.
+ */
+export function affectedPaths(body) {
+    const text = sections(body).get('affected areas') ?? '';
+    const paths = [];
+    for (const line of text.split(/\r?\n/)) {
+        const path = LISTED_PATH.exec(line)?.[1];
+        if (path !== undefined && !paths.includes(path))
+            paths.push(path);
+    }
+    return paths;
+}
+//# sourceMappingURL=sections.js.map

package/dist/ticket/sections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sections.js","sourceRoot":"","sources":["../../src/ticket/sections.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,OAAO,GAAG,sBAAsB,CAAC;AACvC,MAAM,QAAQ,GAAG,2BAA2B,CAAC;AAC7C,MAAM,WAAW,GAAG,eAAe,CAAC;AAEpC,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,OAAO,OAAO;SACX,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;SACjB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;SAClD,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,IAAI,GAAuB,CAAC;IAC5B,IAAI,KAAK,GAAa,EAAE,CAAC;IACzB,MAAM,KAAK,GAAG,GAAS,EAAE;QACvB,IAAI,GAAG,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACpF,CAAC,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACxC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,SAAS;QACX,CAAC;QACD,KAAK,EAAE,CAAC;QACR,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;QAC1B,KAAK,GAAG,EAAE,CAAC;IACb,CAAC;IACD,KAAK,EAAE,CAAC;IACR,OAAO,KAAK,CAAC;AACf,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,UAAU,CAAC,IAAwB;IACjD,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACrC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,OAAO,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,WAAW,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;AAC1E,CAAC;AAED,MAAM,WAAW,GAAG,sCAAsC,CAAC;AAE3D;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC;IACxD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACzC,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/ticket/stale.js

@@ -0,0 +1,108 @@
+import { z } from 'zod';
+import { issueOfBranch, releasedLabels } from './claim.js';
+import { addComment, branchHead, changeLabels, deleteBranch, encodePath, getIssue, openPullsFrom, } from './github.js';
+import { LABEL } from './labels.js';
+import { refSchema, timelineSchema } from './schemas.js';
+/** A claim idle this long is released, unless a PR from it is ready for review. */
+export const STALE_HOURS = 4;
+const HOUR = 3_600_000;
+/**
+ * Idle time runs from the newest of the claim, the last push and the draft PR's last change, so
+ * a branch created at an old `main` isn't stale for that alone.
+ */
+export function staleness(activity, now) {
+    if (activity.readyPull)
+        return { stale: false, idleHours: null, why: 'in-review' };
+    const times = [activity.claimedAt, activity.pushedAt, activity.draftUpdatedAt]
+        .map((t) => (t === undefined ? Number.NaN : Date.parse(t)))
+        .filter((t) => !Number.isNaN(t));
+    if (times.length === 0)
+        return { stale: false, idleHours: null, why: 'no-activity-known' };
+    const idle = now.getTime() - Math.max(...times);
+    const idleHours = Math.max(0, Math.floor(idle / HOUR));
+    return idle > STALE_HOURS * HOUR
+        ? { stale: true, idleHours, why: 'idle' }
+        : { stale: false, idleHours, why: 'active' };
+}
+/** Every `<P>-<N>` branch: every claim, open or left behind. */
+export async function ticketBranches(gh, repo, prefix) {
+    const branchPrefix = `${prefix}-`;
+    const data = await gh.request('GET', `repos/${repo}/git/matching-refs/heads/${encodePath(branchPrefix)}`);
+    return z
+        .array(refSchema)
+        .parse(data)
+        .flatMap((ref) => {
+        const branch = ref.ref.replace(/^refs\/heads\//, '');
+        const issue = issueOfBranch(prefix, branch);
+        return issue === undefined ? [] : [{ branch, issue }];
+    });
+}
+async function claimedAt(gh, repo, issue) {
+    const events = timelineSchema.parse(await gh.paginate(`repos/${repo}/issues/${issue}/timeline`));
+    return events
+        .filter((e) => e.event === 'labeled' && e.label?.name === LABEL.inProgress)
+        .map((e) => e.created_at)
+        .filter((t) => t !== undefined)
+        .at(-1);
+}
+async function activityOf(gh, repo, claim) {
+    const pulls = await openPullsFrom(gh, repo, claim.branch);
+    const draft = pulls.find((p) => p.draft);
+    if (pulls.some((p) => !p.draft))
+        return { activity: { readyPull: true }, draft };
+    const head = await branchHead(gh, repo, claim.branch);
+    const activity = {
+        readyPull: false,
+        claimedAt: await claimedAt(gh, repo, claim.issue),
+        pushedAt: head?.date,
+        draftUpdatedAt: draft?.updatedAt,
+    };
+    return { activity, draft };
+}
+/**
+ * Releases a claim labels first and branch last, so that a step refused part-way leaves the
+ * branch, which the next sweep finds and finishes; a deleted branch with the claim's labels still
+ * on its issue would be stranded, since every sweep starts from the branches. Deleting the branch
+ * closes its draft, so no pull request needs writing.
+ */
+async function releaseStale(c, repo, stale) {
+    await changeLabels(c.gh, repo, stale.issue.number, releasedLabels(stale.issue));
+    await deleteBranch(c.refs, repo, stale.branch);
+    const idle = `${stale.idleHours} h (limit ${STALE_HOURS} h)`;
+    if (stale.issue.state === 'open') {
+        await addComment(c.gh, repo, stale.issue.number, `🔓 released: the claim was idle for ${idle}; branch \`${stale.branch}\` is deleted ` +
+            'and the ticket is open to claim again.');
+    }
+    if (stale.draft !== undefined) {
+        await addComment(c.gh, repo, stale.draft.number, `Closed by Talos: the claim on #${stale.issue.number} was idle for ${idle}. ` +
+            'The commits stay on this pull request.').catch(() => undefined);
+    }
+}
+/** Releases every claim idle longer than {@link STALE_HOURS}; one failure doesn't stop the rest. */
+export async function sweepStaleClaims(c, at) {
+    const released = [];
+    let kept = 0;
+    let failed = 0;
+    for (const claim of await ticketBranches(c.gh, at.repo, at.prefix)) {
+        try {
+            const issue = await getIssue(c.gh, at.repo, claim.issue);
+            if (issue === undefined || issue.isPull) {
+                kept += 1;
+                continue;
+            }
+            const { activity, draft } = await activityOf(c.gh, at.repo, claim);
+            const verdict = staleness(activity, at.now);
+            if (!verdict.stale || verdict.idleHours === null) {
+                kept += 1;
+                continue;
+            }
+            await releaseStale(c, at.repo, { ...claim, issue, draft, idleHours: verdict.idleHours });
+            released.push(claim.issue);
+        }
+        catch {
+            failed += 1;
+        }
+    }
+    return { released, kept, failed };
+}
+//# sourceMappingURL=stale.js.map

package/dist/ticket/stale.js.map

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

package/dist/ticket/status.js

@@ -0,0 +1,96 @@
+import { z } from 'zod';
+import { branchFor, claimantOf } from './claim.js';
+import { branchHead, getIssue, listComments } from './github.js';
+const pullNode = z.object({
+    number: z.number().int().positive(),
+    isDraft: z.boolean(),
+    state: z.enum(['OPEN', 'CLOSED', 'MERGED']),
+    mergeQueueEntry: z.object({ state: z.string() }).nullable().optional(),
+    commits: z.object({
+        nodes: z.array(z.object({
+            commit: z.object({
+                statusCheckRollup: z.object({ state: z.string() }).nullable().optional(),
+            }),
+        })),
+    }),
+});
+const pullQuery = z.object({
+    repository: z.object({ pullRequests: z.object({ nodes: z.array(pullNode) }) }).nullable(),
+});
+const QUERY = `query($owner: String!, $name: String!, $branch: String!) {
+  repository(owner: $owner, name: $name) {
+    pullRequests(headRefName: $branch, first: 1, orderBy: {field: CREATED_AT, direction: DESC}) {
+      nodes {
+        number isDraft state
+        mergeQueueEntry { state }
+        commits(last: 1) { nodes { commit { statusCheckRollup { state } } } }
+      }
+    }
+  }
+}`;
+export function pullStage(pr) {
+    if (pr.state === 'MERGED')
+        return 'merged';
+    if (pr.state === 'CLOSED')
+        return 'closed';
+    if (pr.isDraft)
+        return 'draft';
+    return pr.inQueue ? 'queued' : 'ready';
+}
+/** GitHub's combined state of every check and status on a commit. */
+export function checksState(rollup) {
+    switch (rollup) {
+        case 'SUCCESS': {
+            return 'green';
+        }
+        case 'FAILURE':
+        case 'ERROR': {
+            return 'red';
+        }
+        case 'PENDING':
+        case 'EXPECTED': {
+            return 'pending';
+        }
+        default: {
+            return 'none';
+        }
+    }
+}
+function describePull(node) {
+    const rollup = node.commits.nodes[0]?.commit.statusCheckRollup?.state;
+    return {
+        number: node.number,
+        stage: pullStage({
+            state: node.state,
+            isDraft: node.isDraft,
+            inQueue: node.mergeQueueEntry !== undefined && node.mergeQueueEntry !== null,
+        }),
+        checks: checksState(rollup),
+    };
+}
+async function latestPull(t, branch) {
+    const [owner, name] = t.repo.split('/');
+    const data = pullQuery.parse(await t.gh.graphql(QUERY, { owner, name, branch }));
+    const node = data.repository?.pullRequests.nodes[0];
+    return node === undefined ? null : describePull(node);
+}
+/** A ticket's claim, branch and PR, as `talos ticket status` prints them. */
+export async function ticketStatus(t, n) {
+    const branch = branchFor(t.prefix, n);
+    const issue = await getIssue(t.gh, t.repo, n);
+    const head = await branchHead(t.gh, t.repo, branch);
+    const claimant = head === undefined ? undefined : claimantOf(await listComments(t.gh, t.repo, n), t.who);
+    return {
+        result: 'status',
+        issue: n,
+        branch,
+        state: issue?.state ?? null,
+        labels: issue === undefined ? [] : [...issue.labels],
+        claimed: head !== undefined,
+        agent: claimant?.agent ?? null,
+        since: claimant?.at ?? null,
+        lastCommit: head === undefined ? null : { sha: head.sha, date: head.date ?? null },
+        pr: await latestPull(t, branch),
+    };
+}
+//# sourceMappingURL=status.js.map

package/dist/ticket/status.js.map

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

package/dist/ticket/trust.js

@@ -0,0 +1,29 @@
+import { sameLogin } from '../github/identities.js';
+/**
+ * The `author_association` values of people who may steer an agent. Strangers can comment on a
+ * public repository's issues and PRs; their words are data, and nothing they write starts a job.
+ */
+const TRUSTED_ASSOCIATIONS = new Set(['OWNER', 'MEMBER', 'COLLABORATOR']);
+/**
+ * Whether an author is the owner, a member or a collaborator, or one of the Apps Talos itself
+ * names. An App's `author_association` is not `COLLABORATOR`, so Thea's App and Talos's own are
+ * recognised by login, which no person can take: logins ending in `[bot]` belong to Apps.
+ */
+export function isTrusted(author, who) {
+    if (author.association !== undefined && TRUSTED_ASSOCIATIONS.has(author.association)) {
+        return true;
+    }
+    return [who.owner, who.thea, who.reviewer, who.release].some((id) => sameLogin(author.login, id));
+}
+/** Whether Talos's own Apps wrote it: issues and comments Talos files itself. */
+export function isTalos(login, who) {
+    return sameLogin(login, who.reviewer) || sameLogin(login, who.release);
+}
+/**
+ * Text Thea's tools write must never carry the approval marker: `talos/review` reads a
+ * `talos-approve` review from her App as the owner's okay, and only her card may write one.
+ */
+export function carriesApproval(text) {
+    return /talos-approve/i.test(text);
+}
+//# sourceMappingURL=trust.js.map

package/dist/ticket/trust.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trust.js","sourceRoot":"","sources":["../../src/ticket/trust.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAErE;;;GAGG;AACH,MAAM,oBAAoB,GAAwB,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC;AAO/F;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,MAAc,EAAE,GAAe;IACvD,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,IAAI,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;QACrF,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;AACpG,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,OAAO,CAAC,KAAyB,EAAE,GAAe;IAChE,OAAO,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;AACzE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC"}

package/dist/tools/fetch.js

@@ -0,0 +1,117 @@
+import { createHash } from 'node:crypto';
+import { access, chmod, mkdir, readFile, rename, rm } from 'node:fs/promises';
+import { dirname, join, win32 } from 'node:path';
+import { EngineError } from '../core/check.js';
+const DOWNLOAD_TIMEOUT = 15 * 60 * 1000;
+/** How a download is unpacked: by its kind, then by the URL's extension. */
+export function formatOf(kind, url) {
+    if (kind === 'binary')
+        return 'file';
+    if (kind === 'psgallery')
+        return 'zip';
+    const path = new URL(url).pathname.toLowerCase();
+    if (path.endsWith('.zip'))
+        return 'zip';
+    if (/\.(tar\.gz|tgz|tar\.xz|txz|tar\.bz2|tbz2?)$/.test(path))
+        return 'tar';
+    throw new EngineError(`tools.lock: no way to unpack ${url}`);
+}
+/**
+ * curl follows redirects (release downloads redirect to a CDN) over https only, retries
+ * transient failures, and honours HTTPS_PROXY; Windows ships it as curl.exe.
+ */
+export function curlArgs(url, output) {
+    return [
+        '--fail',
+        '--location',
+        '--silent',
+        '--show-error',
+        '--retry',
+        '3',
+        '--proto',
+        '=https,file',
+        '--proto-redir',
+        '=https',
+        '--output',
+        output,
+        url,
+    ];
+}
+/**
+ * The program that unpacks an archive. On Windows it is the system's own bsdtar, which reads
+ * zip files too; a GNU tar earlier on PATH (Git's) would take `C:\…` for a remote host.
+ */
+export function unpackCommand(format, archive, into, host) {
+    if (host.platform === 'win32') {
+        const tar = win32.join(host.systemRoot ?? 'C:\\Windows', 'System32', 'tar.exe');
+        return { command: tar, args: ['-xf', archive, '-C', into] };
+    }
+    if (format === 'zip')
+        return { command: 'unzip', args: ['-q', '-o', archive, '-d', into] };
+    return { command: 'tar', args: ['-xf', archive, '-C', into] };
+}
+async function sha256Of(file) {
+    return createHash('sha256')
+        .update(await readFile(file))
+        .digest('hex');
+}
+function last(result) {
+    return (result.stderr || result.stdout).trim().split('\n').slice(-5).join('\n');
+}
+async function run(ctx, command, args, cwd) {
+    let result;
+    try {
+        result = await ctx.exec(command, args, { cwd, timeoutMs: DOWNLOAD_TIMEOUT });
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        throw new EngineError(`${command} is needed to fetch Talos's tools: ${reason}`);
+    }
+    if (result.code !== 0) {
+        throw new EngineError(`${command} ${args.join(' ')} exited ${result.code}: ${last(result)}`);
+    }
+}
+async function exists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Downloads a tool into `work`, refuses it unless its sha256 is the one `tools.lock` pins,
+ * and unpacks it there; its executable is marked executable.
+ */
+export async function fetchInto(ctx, job) {
+    const { name, tool, download, work } = job;
+    const file = join(work, '.download');
+    await run(ctx, 'curl', curlArgs(download.url, file), work);
+    const actual = await sha256Of(file);
+    if (actual !== download.sha256) {
+        await rm(file, { force: true });
+        throw new EngineError(`refusing ${name} ${tool.version}: ${download.url} has sha256 ${actual}, ` +
+            `but tools.lock pins ${download.sha256}`);
+    }
+    const target = join(work, download.path);
+    const format = formatOf(tool.kind, download.url);
+    if (format === 'file') {
+        await mkdir(dirname(target), { recursive: true });
+        await rename(file, target);
+    }
+    else {
+        const unpack = unpackCommand(format, file, work, {
+            platform: ctx.platform,
+            systemRoot: ctx.env.SystemRoot,
+        });
+        await run(ctx, unpack.command, unpack.args, work);
+        await rm(file, { force: true });
+    }
+    if (!(await exists(target))) {
+        throw new EngineError(`${name} ${tool.version} from ${download.url} has no ${download.path}`);
+    }
+    if (tool.kind !== 'psgallery')
+        await chmod(target, 0o755);
+}
+//# sourceMappingURL=fetch.js.map

package/dist/tools/fetch.js.map

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