@svp-labs/talos 0.0.0 → 0.1.1

package/dist/status/schema.js

@@ -0,0 +1,110 @@
+import { z } from 'zod';
+export const STATUS_SCHEMA = 'talos.status/1';
+/** Lists are cut here and carry their total. */
+export const MAX_LISTED = 20;
+/** Security issues listed by priority. */
+export const MAX_TOP = 5;
+export const MAX_TITLE = 100;
+export const MAX_MESSAGE = 200;
+const count = z.number().int().min(0);
+const number = z.number().int().positive();
+const sha = z.string().regex(/^[0-9a-f]{40}$/);
+const title = z.string().max(MAX_TITLE);
+const timestamp = z.string().describe('ISO 8601 date and time');
+const checkState = z
+    .enum(['green', 'red', 'pending', 'unknown'])
+    .describe('red when any run failed, pending while any runs, unknown when none ran');
+function capped(item) {
+    return z.strictObject({ total: count, items: z.array(item).max(MAX_LISTED) });
+}
+const claim = z.strictObject({
+    branch: z.string().describe('the ticket branch <P>-<N>: the claim itself'),
+    issue: number,
+    by: z.string().nullable().describe('the agent or person named by the claim comment'),
+    since: timestamp.nullable(),
+    pr: number.nullable().describe('the open PR from the branch'),
+});
+const reviewer = z.strictObject({
+    verdict: z.enum(['APPROVE', 'REQUEST_CHANGES', 'COMMENT']),
+    round: count.nullable(),
+    findings: count.nullable(),
+});
+const pullRequest = z.strictObject({
+    number,
+    title,
+    branch: z.string(),
+    issue: number.nullable().describe('the ticket the branch names'),
+    author: z.string().nullable(),
+    stage: z.enum(['draft', 'ready', 'queued']),
+    gate: checkState.describe("the Talos gate's latest run on the PR's head"),
+    review: checkState.describe('the talos/review check on the head'),
+    reviewer: reviewer.nullable().describe("talos-reviewer's latest review (talos-review/1 line)"),
+    automerge: z.boolean(),
+});
+const securityIssue = z.strictObject({
+    number,
+    title,
+    priority: z.enum(['p0', 'p1', 'p2', 'p3']).nullable(),
+});
+const card = z.strictObject({
+    id: z.string(),
+    pr: number.nullable(),
+    title,
+    since: timestamp,
+});
+const repoStatusSchema = z
+    .strictObject({
+    schema: z.literal(STATUS_SCHEMA),
+    repo: z.string().describe('owner/name'),
+    channel: z.enum(['evaluate', 'canary', 'stable']).nullable(),
+    agents: z.boolean().describe('whether the talos-agents property lets agents work here'),
+    pin: z
+        .strictObject({ sha, version: z.string().nullable(), source: z.string() })
+        .nullable()
+        .describe('the enforced Talos release; null when no single pin was found'),
+    main: z
+        .strictObject({ branch: z.string(), sha, gate: checkState, review: checkState })
+        .nullable(),
+    claims: capped(claim),
+    prs: capped(pullRequest),
+    security: z.strictObject({ open: count, top: z.array(securityIssue).max(MAX_TOP) }),
+    debt: z.strictObject({ open: count.describe('open debt/dead-code and debt/other issues') }),
+    drift: z.strictObject({
+        open: count,
+        last: z
+            .strictObject({ number, date: timestamp, state: z.enum(['open', 'closed']) })
+            .nullable(),
+    }),
+    problems: z
+        .array(z.string().max(MAX_MESSAGE))
+        .max(MAX_TOP)
+        .describe('what could not be read; the rest of the object still holds'),
+    cards: capped(card)
+        .optional()
+        .describe("added by Thea's hub: approval cards waiting on the owner; Talos never sets it"),
+})
+    .describe("one governed repository's state");
+const statusErrorSchema = z
+    .strictObject({
+    schema: z.literal(STATUS_SCHEMA),
+    repo: z.string(),
+    error: z.string().max(MAX_MESSAGE),
+})
+    .describe('a repository whose state could not be read');
+/** One element of `talos status --json`'s array. */
+export const statusSchema = z
+    .union([repoStatusSchema, statusErrorSchema])
+    .meta({ title: STATUS_SCHEMA, description: "A governed repository's current state" });
+/** The JSON Schema of `talos.status/1`, as `docs/contracts/status.schema.json` holds it. */
+export function statusJsonSchema() {
+    return {
+        $id: 'https://github.com/SVP-Labs/Talos/blob/main/docs/contracts/status.schema.json',
+        ...z.toJSONSchema(statusSchema, { target: 'draft-2020-12' }),
+    };
+}
+/** Text from GitHub on one line and within `max` characters. */
+export function clip(text, max) {
+    const line = text.replaceAll(/[\s\p{Cc}]+/gu, ' ').trim();
+    return line.length <= max ? line : `${line.slice(0, max - 1)}…`;
+}
+//# sourceMappingURL=schema.js.map

package/dist/status/schema.js.map

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

package/dist/status/text.js

@@ -0,0 +1,57 @@
+function short(sha) {
+    return sha.slice(0, 12);
+}
+function day(timestamp) {
+    return timestamp === null ? 'unknown' : timestamp.slice(0, 10);
+}
+function more(total, shown) {
+    return total > shown ? `, and ${total - shown} more` : '';
+}
+function reviewerText(reviewer) {
+    if (reviewer === null)
+        return '';
+    const round = reviewer.round === null ? '' : ` round ${reviewer.round}`;
+    return `, reviewer ${reviewer.verdict}${round}`;
+}
+function prLine(pr) {
+    const checks = `gate ${pr.gate}, review ${pr.review}${reviewerText(pr.reviewer)}`;
+    const merge = pr.automerge ? ', auto-merge on' : '';
+    return `    #${pr.number} ${pr.stage}: ${checks}${merge} · ${pr.title}`;
+}
+function header(status) {
+    const pin = status.pin === null
+        ? 'no pin'
+        : `Talos ${status.pin.version ?? '?'} (${short(status.pin.sha)}, ${status.pin.source})`;
+    const agents = status.agents ? 'agents on' : 'agents off';
+    return `${status.repo} · ${status.channel ?? 'no channel'} · ${pin} · ${agents}`;
+}
+function repoText(status) {
+    const lines = [header(status)];
+    if (status.main !== null) {
+        const { main } = status;
+        lines.push(`  ${main.branch} ${short(main.sha)}: gate ${main.gate}, review ${main.review}`);
+    }
+    lines.push(`  claims: ${status.claims.total}${more(status.claims.total, status.claims.items.length)}`);
+    for (const claim of status.claims.items) {
+        const pr = claim.pr === null ? '' : `, PR #${claim.pr}`;
+        lines.push(`    ${claim.branch} by ${claim.by ?? 'unknown'} since ${day(claim.since)}${pr}`);
+    }
+    lines.push(`  open PRs: ${status.prs.total}${more(status.prs.total, status.prs.items.length)}`);
+    lines.push(...status.prs.items.map(prLine));
+    lines.push(`  security: ${status.security.open} open`);
+    for (const issue of status.security.top) {
+        lines.push(`    #${issue.number} ${issue.priority ?? 'p?'} · ${issue.title}`);
+    }
+    const drift = status.drift.last === null
+        ? 'no report yet'
+        : `last #${status.drift.last.number} ${day(status.drift.last.date)} (${status.drift.last.state})`;
+    lines.push(`  debt: ${status.debt.open} open · drift: ${status.drift.open} open, ${drift}`);
+    lines.push(...status.problems.map((problem) => `  problem: ${problem}`));
+    return lines;
+}
+/** `talos status` for a person: one block per repository. */
+export function statusText(statuses) {
+    const blocks = statuses.map((status) => 'error' in status ? `${status.repo}: ${status.error}` : repoText(status).join('\n'));
+    return `${blocks.join('\n\n')}\n`;
+}
+//# sourceMappingURL=text.js.map

package/dist/status/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../src/status/text.ts"],"names":[],"mappings":"AAEA,SAAS,KAAK,CAAC,GAAW;IACxB,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,GAAG,CAAC,SAAwB;IACnC,OAAO,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,SAAS,IAAI,CAAC,KAAa,EAAE,KAAa;IACxC,OAAO,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5D,CAAC;AAED,SAAS,YAAY,CAAC,QAAgC;IACpD,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxE,OAAO,cAAc,QAAQ,CAAC,OAAO,GAAG,KAAK,EAAE,CAAC;AAClD,CAAC;AAED,SAAS,MAAM,CAAC,EAAqB;IACnC,MAAM,MAAM,GAAG,QAAQ,EAAE,CAAC,IAAI,YAAY,EAAE,CAAC,MAAM,GAAG,YAAY,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;IAClF,MAAM,KAAK,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,OAAO,QAAQ,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC,KAAK,KAAK,MAAM,GAAG,KAAK,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;AAC1E,CAAC;AAED,SAAS,MAAM,CAAC,MAAkB;IAChC,MAAM,GAAG,GACP,MAAM,CAAC,GAAG,KAAK,IAAI;QACjB,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,KAAK,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC;IAC5F,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC;IAC1D,OAAO,GAAG,MAAM,CAAC,IAAI,MAAM,MAAM,CAAC,OAAO,IAAI,YAAY,MAAM,GAAG,MAAM,MAAM,EAAE,CAAC;AACnF,CAAC;AAED,SAAS,QAAQ,CAAC,MAAkB;IAClC,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/B,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QACzB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,IAAI,CAAC,IAAI,YAAY,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9F,CAAC;IACD,KAAK,CAAC,IAAI,CACR,aAAa,MAAM,CAAC,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAC3F,CAAC;IACF,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACxC,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,EAAE,EAAE,CAAC;QACxD,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,MAAM,OAAO,KAAK,CAAC,EAAE,IAAI,SAAS,UAAU,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC/F,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAChG,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5C,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,CAAC;IACvD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,QAAQ,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,IAAI,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IAChF,CAAC;IACD,MAAM,KAAK,GACT,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI;QACxB,CAAC,CAAC,eAAe;QACjB,CAAC,CAAC,SAAS,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC;IACtG,KAAK,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,IAAI,CAAC,IAAI,kBAAkB,MAAM,CAAC,KAAK,CAAC,IAAI,UAAU,KAAK,EAAE,CAAC,CAAC;IAC5F,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,cAAc,OAAO,EAAE,CAAC,CAAC,CAAC;IACzE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,UAAU,CAAC,QAA2B;IACpD,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CACrC,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CACpF,CAAC;IACF,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;AACpC,CAAC"}

package/dist/ticket/claim.js

@@ -0,0 +1,147 @@
+import { addComment, branchHead, changeLabels, defaultBranch, deleteBranch, getIssue, listComments, openPullsFrom, refSha, } from './github.js';
+import { LABEL, CLAIM_BLOCKERS } from './labels.js';
+import { ticketPayload } from './payload.js';
+import { carriesApproval, isTrusted } from './trust.js';
+import { GitHubError } from '../github/api.js';
+export function branchFor(prefix, issue) {
+    return `${prefix}-${issue}`;
+}
+/** The issue a ticket branch names, or `undefined` for any other branch. */
+export function issueOfBranch(prefix, branch) {
+    if (!branch.startsWith(`${prefix}-`))
+        return undefined;
+    const rest = branch.slice(prefix.length + 1);
+    return /^[1-9]\d{0,8}$/.test(rest) ? Number(rest) : undefined;
+}
+const AGENT = /^[A-Za-z0-9][\w.-]{0,38}$/;
+export function agentProblem(agent) {
+    if (!AGENT.test(agent)) {
+        return 'an agent id is 1 to 39 letters, digits, dots, dashes or underscores';
+    }
+    return carriesApproval(agent) ? 'an agent id may not contain talos-approve' : undefined;
+}
+export function reasonProblem(reason) {
+    if (reason.trim() === '' || /[\r\n]/.test(reason) || reason.length > 200) {
+        return 'a reason is one line of at most 200 characters';
+    }
+    return carriesApproval(reason) ? 'a reason may not contain talos-approve' : undefined;
+}
+function stamp(now) {
+    return now.toISOString().replace(/\.\d{3}Z$/, 'Z');
+}
+export function claimLine(agent, now) {
+    return `🔒 claimed by ${agent} · ${stamp(now)}`;
+}
+const CLAIM_LINE = /^🔒 claimed by (\S+) · (\S+)/u;
+/** The latest claim comment a trusted author wrote; anyone can type the same words. */
+export function claimantOf(comments, who) {
+    for (const comment of [...comments].reverse()) {
+        const match = CLAIM_LINE.exec(comment.body);
+        if (match?.[1] === undefined || match[2] === undefined)
+            continue;
+        if (!isTrusted({ login: comment.author, association: comment.association }, who))
+            continue;
+        return { agent: match[1], at: match[2] };
+    }
+    return undefined;
+}
+/** Refusals about the issue itself, which hold whether or not anyone holds its branch. */
+const ISSUE_REFUSALS = new Set(['not-found', 'not-an-issue', 'closed']);
+/** Why an issue can't be claimed, or `undefined` when it can. */
+export function claimRefusal(issue) {
+    if (issue === undefined)
+        return 'not-found';
+    if (issue.isPull)
+        return 'not-an-issue';
+    if (issue.state === 'closed')
+        return 'closed';
+    if (!issue.labels.includes(LABEL.ready))
+        return 'not-ready';
+    return CLAIM_BLOCKERS.find((label) => issue.labels.includes(label));
+}
+/** The labels a ticket carries once its claim is released. */
+export function releasedLabels(issue) {
+    const remove = [LABEL.inProgress, LABEL.claimed].filter((l) => issue.labels.includes(l));
+    const reopen = issue.state === 'open' &&
+        !issue.labels.includes(LABEL.ready) &&
+        !issue.labels.includes(LABEL.needsSpec) &&
+        !issue.labels.includes(LABEL.epic);
+    return { add: reopen ? [LABEL.ready] : [], remove };
+}
+/** Creates the ticket's branch at the default branch's head; `false` when it already exists. */
+async function lock(t, branch) {
+    const base = await refSha(t.gh, t.repo, await defaultBranch(t.gh, t.repo));
+    try {
+        await t.gh.request('POST', `repos/${t.repo}/git/refs`, {
+            body: { ref: `refs/heads/${branch}`, sha: base },
+        });
+        return true;
+    }
+    catch (error) {
+        const exists = error instanceof GitHubError &&
+            error.status === 422 &&
+            (await branchHead(t.gh, t.repo, branch)) !== undefined;
+        if (exists)
+            return false;
+        throw error;
+    }
+}
+/** Someone else holds the ticket: the agent a trusted claim comment names, if one does yet. */
+async function taken(t, n) {
+    const by = claimantOf(await listComments(t.gh, t.repo, n), t.who)?.agent ?? null;
+    return { result: 'taken', by };
+}
+/**
+ * Refuses an issue, unless someone holds it. A claim takes `status/ready` off its ticket, so a
+ * held ticket would otherwise read as not ready: an open issue refused for its labels is looked
+ * up first, since who holds it is the answer then.
+ */
+async function refused(t, n, reason) {
+    if (!ISSUE_REFUSALS.has(reason)) {
+        const held = await branchHead(t.gh, t.repo, branchFor(t.prefix, n));
+        if (held !== undefined)
+            return await taken(t, n);
+    }
+    return { result: 'refused', reason };
+}
+export async function claim(t, n, agent) {
+    const issue = await getIssue(t.gh, t.repo, n);
+    const refusal = claimRefusal(issue);
+    if (refusal !== undefined || issue === undefined) {
+        return await refused(t, n, refusal ?? 'not-found');
+    }
+    const branch = branchFor(t.prefix, n);
+    if (!(await lock(t, branch)))
+        return await taken(t, n);
+    const add = [LABEL.inProgress, LABEL.claimed].filter((l) => !issue.labels.includes(l));
+    try {
+        await changeLabels(t.gh, t.repo, n, { add, remove: [LABEL.ready] });
+        await addComment(t.gh, t.repo, n, claimLine(agent, t.now));
+    }
+    catch (error) {
+        // A claim nobody knows they hold would sit until the stale sweep: give it back at once.
+        await deleteBranch(t.gh, t.repo, branch).catch(() => false);
+        throw error;
+    }
+    const labels = [...issue.labels.filter((l) => l !== LABEL.ready), ...add];
+    const comments = await listComments(t.gh, t.repo, n);
+    return {
+        result: 'claimed',
+        ticket: { branch, agent, ...ticketPayload({ ...issue, labels }, comments, t.who) },
+    };
+}
+/** Gives a ticket back: its branch goes, unless a PR is open from it, and it is ready again. */
+export async function release(t, n, reason) {
+    const issue = await getIssue(t.gh, t.repo, n);
+    if (issue === undefined || issue.isPull)
+        return { result: 'refused', reason: 'not-found' };
+    const branch = branchFor(t.prefix, n);
+    const open = await openPullsFrom(t.gh, t.repo, branch);
+    if (open[0] !== undefined)
+        return { result: 'refused', reason: 'open-pr', pr: open[0].number };
+    const deleted = await deleteBranch(t.gh, t.repo, branch);
+    await changeLabels(t.gh, t.repo, n, releasedLabels(issue));
+    await addComment(t.gh, t.repo, n, `🔓 released: ${reason}`);
+    return { result: 'released', branch, deleted };
+}
+//# sourceMappingURL=claim.js.map

package/dist/ticket/claim.js.map

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

package/dist/ticket/github.js

@@ -0,0 +1,94 @@
+import { branchSchema, contentsFileSchema, parseComments, parseIssue, parsePulls, refSchema, repoSchema, } from './schemas.js';
+import { parseConfig } from '../config/load.js';
+import { GitHubError } from '../github/api.js';
+/** Thin calls over the REST API, each validating what it returns. */
+export function encodePath(path) {
+    return path.split('/').map(encodeURIComponent).join('/');
+}
+export async function defaultBranch(gh, repo) {
+    return repoSchema.parse(await gh.request('GET', `repos/${repo}`)).default_branch;
+}
+/** An issue, or `undefined` when it doesn't exist. Pull requests come back as issues too. */
+export async function getIssue(gh, repo, n) {
+    const data = await gh.request('GET', `repos/${repo}/issues/${n}`, {
+        allowMissing: true,
+    });
+    return data === undefined ? undefined : parseIssue(data);
+}
+export async function listComments(gh, repo, n) {
+    return parseComments(await gh.paginate(`repos/${repo}/issues/${n}/comments`));
+}
+export async function addComment(gh, repo, n, body) {
+    await gh.request('POST', `repos/${repo}/issues/${n}/comments`, { body: { body } });
+}
+export async function addLabels(gh, repo, n, labels) {
+    if (labels.length === 0)
+        return;
+    await gh.request('POST', `repos/${repo}/issues/${n}/labels`, { body: { labels } });
+}
+/** Removing a label the issue doesn't carry is not an error. */
+async function removeLabel(gh, repo, n, label) {
+    await gh.request('DELETE', `repos/${repo}/issues/${n}/labels/${encodeURIComponent(label)}`, {
+        allowMissing: true,
+    });
+}
+export async function changeLabels(gh, repo, n, change) {
+    for (const label of change.remove)
+        await removeLabel(gh, repo, n, label);
+    await addLabels(gh, repo, n, change.add);
+}
+/** The commit a branch points at, or `undefined` when there is no such branch. */
+export async function branchHead(gh, repo, branch) {
+    const data = await gh.request('GET', `repos/${repo}/branches/${encodePath(branch)}`, {
+        allowMissing: true,
+    });
+    if (data === undefined)
+        return undefined;
+    const commit = branchSchema.parse(data).commit;
+    return { sha: commit.sha, date: commit.commit.committer?.date };
+}
+export async function refSha(gh, repo, branch) {
+    const data = await gh.request('GET', `repos/${repo}/git/ref/heads/${encodePath(branch)}`);
+    return refSchema.parse(data).object.sha;
+}
+/**
+ * Deletes a branch. A branch that is already gone answers 422 or 404, which is the outcome
+ * wanted; any other refusal (403 for a token without `contents: write`) throws.
+ */
+export async function deleteBranch(gh, repo, branch) {
+    try {
+        await gh.request('DELETE', `repos/${repo}/git/refs/heads/${encodePath(branch)}`, {
+            allowMissing: true,
+        });
+        return true;
+    }
+    catch (error) {
+        if (error instanceof GitHubError && error.status === 422)
+            return false;
+        throw error;
+    }
+}
+/** The open pull requests whose head is `branch` in the repository itself. */
+export async function openPullsFrom(gh, repo, branch) {
+    const owner = repo.split('/')[0] ?? '';
+    const head = encodeURIComponent(`${owner}:${branch}`);
+    const data = await gh.request('GET', `repos/${repo}/pulls?state=open&head=${head}`);
+    return parsePulls(data).filter((p) => p.headRef === branch);
+}
+/** A file's text at a ref, or `undefined` when it doesn't exist there. */
+export async function fileAt(gh, repo, path, ref) {
+    const data = await gh.request('GET', `repos/${repo}/contents/${encodePath(path)}?ref=${encodeURIComponent(ref)}`, { allowMissing: true });
+    if (data === undefined)
+        return undefined;
+    const file = contentsFileSchema.safeParse(data);
+    return file.success ? Buffer.from(file.data.content, 'base64').toString('utf8') : undefined;
+}
+/** `talos.yml` as it is at a ref, read through the API. */
+export async function configAt(gh, repo, ref) {
+    const text = await fileAt(gh, repo, 'talos.yml', ref);
+    if (text === undefined) {
+        throw new Error(`talos.yml not found at ${ref}: the repository is not governed`);
+    }
+    return parseConfig(text);
+}
+//# sourceMappingURL=github.js.map

package/dist/ticket/github.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.js","sourceRoot":"","sources":["../../src/ticket/github.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAEZ,kBAAkB,EAElB,aAAa,EACb,UAAU,EACV,UAAU,EAEV,SAAS,EACT,UAAU,GACX,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAe,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE5D,qEAAqE;AAErE,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,EAAU,EAAE,IAAY;IAC1D,OAAO,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,OAAO,CAAU,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC;AAC5F,CAAC;AAED,6FAA6F;AAC7F,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,EAAU,EAAE,IAAY,EAAE,CAAS;IAChE,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,OAAO,CAAU,KAAK,EAAE,SAAS,IAAI,WAAW,CAAC,EAAE,EAAE;QACzE,YAAY,EAAE,IAAI;KACnB,CAAC,CAAC;IACH,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,EAAU,EAAE,IAAY,EAAE,CAAS;IACpE,OAAO,aAAa,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAU,SAAS,IAAI,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC;AACzF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,EAAU,EAAE,IAAY,EAAE,CAAS,EAAE,IAAY;IAChF,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,IAAI,WAAW,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;AACrF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,EAAU,EACV,IAAY,EACZ,CAAS,EACT,MAAyB;IAEzB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAChC,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,IAAI,WAAW,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;AACrF,CAAC;AAED,gEAAgE;AAChE,KAAK,UAAU,WAAW,CAAC,EAAU,EAAE,IAAY,EAAE,CAAS,EAAE,KAAa;IAC3E,MAAM,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,SAAS,IAAI,WAAW,CAAC,WAAW,kBAAkB,CAAC,KAAK,CAAC,EAAE,EAAE;QAC1F,YAAY,EAAE,IAAI;KACnB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,EAAU,EACV,IAAY,EACZ,CAAS,EACT,MAA+E;IAE/E,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM;QAAE,MAAM,WAAW,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;IACzE,MAAM,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;AAC3C,CAAC;AAED,kFAAkF;AAClF,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,EAAU,EACV,IAAY,EACZ,MAAc;IAEd,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,OAAO,CAAU,KAAK,EAAE,SAAS,IAAI,aAAa,UAAU,CAAC,MAAM,CAAC,EAAE,EAAE;QAC5F,YAAY,EAAE,IAAI;KACnB,CAAC,CAAC;IACH,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACzC,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;IAC/C,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC;AAClE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,EAAU,EAAE,IAAY,EAAE,MAAc;IACnE,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,OAAO,CAC3B,KAAK,EACL,SAAS,IAAI,kBAAkB,UAAU,CAAC,MAAM,CAAC,EAAE,CACpD,CAAC;IACF,OAAO,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;AAC1C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,EAAU,EAAE,IAAY,EAAE,MAAc;IACzE,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,SAAS,IAAI,mBAAmB,UAAU,CAAC,MAAM,CAAC,EAAE,EAAE;YAC/E,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,WAAW,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG;YAAE,OAAO,KAAK,CAAC;QACvE,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,EAAU,EAAE,IAAY,EAAE,MAAc;IAC1E,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACvC,MAAM,IAAI,GAAG,kBAAkB,CAAC,GAAG,KAAK,IAAI,MAAM,EAAE,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,OAAO,CAAU,KAAK,EAAE,SAAS,IAAI,0BAA0B,IAAI,EAAE,CAAC,CAAC;IAC7F,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC;AAC9D,CAAC;AAED,0EAA0E;AAC1E,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,EAAU,EACV,IAAY,EACZ,IAAY,EACZ,GAAW;IAEX,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,OAAO,CAC3B,KAAK,EACL,SAAS,IAAI,aAAa,UAAU,CAAC,IAAI,CAAC,QAAQ,kBAAkB,CAAC,GAAG,CAAC,EAAE,EAC3E,EAAE,YAAY,EAAE,IAAI,EAAE,CACvB,CAAC;IACF,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACzC,MAAM,IAAI,GAAG,kBAAkB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAChD,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9F,CAAC;AAED,2DAA2D;AAC3D,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,EAAU,EAAE,IAAY,EAAE,GAAW;IAClE,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC;IACtD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,kCAAkC,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC"}

package/dist/ticket/labels.js

@@ -0,0 +1,64 @@
+/**
+ * The label names the claim protocol, issue readiness and Talos's own issues use. Every one of
+ * them is defined, with its meaning, in `assets/labels.yml`, which label sync applies.
+ */
+export const LABEL = {
+    ready: 'status/ready',
+    inProgress: 'status/in-progress',
+    eligible: 'ai/eligible',
+    claimed: 'ai/claimed',
+    needsSpec: 'needs-spec',
+    needsDecision: 'needs-decision',
+    needsHuman: 'needs-human',
+    blocked: 'blocked',
+    legacy: 'legacy',
+    decision: 'decision',
+    epic: 'epic',
+    bug: 'bug',
+    chore: 'chore',
+    deadCode: 'debt/dead-code',
+    debtOther: 'debt/other',
+    flaky: 'flaky',
+    sync: 'sync',
+    p2: 'priority/p2',
+    p3: 'priority/p3',
+};
+/** An issue carries exactly one of these. */
+export const TYPE_LABELS = [
+    'feature',
+    'bug',
+    'chore',
+    'refactor',
+    'spike',
+    LABEL.deadCode,
+    LABEL.debtOther,
+    LABEL.epic,
+];
+/** Labels that keep an issue out of every claim, whatever its status. */
+export const CLAIM_BLOCKERS = [
+    LABEL.blocked,
+    LABEL.legacy,
+    LABEL.needsSpec,
+    LABEL.needsDecision,
+    LABEL.needsHuman,
+    LABEL.epic,
+];
+const PRIORITY = /^priority\/p([0-3])$/;
+/** The most urgent `priority/pN` an issue carries; an issue without one is `p3`. */
+export function priorityOf(labels) {
+    let best = 3;
+    for (const label of labels) {
+        const level = PRIORITY.exec(label)?.[1];
+        if (level !== undefined)
+            best = Math.min(best, Number(level));
+    }
+    return best;
+}
+export function typeLabelsOf(labels) {
+    return labels.filter((label) => TYPE_LABELS.includes(label));
+}
+/** Whether the labels mirror a claim: its branch exists, or did when they were set. */
+export function looksClaimed(labels) {
+    return labels.includes(LABEL.inProgress) || labels.includes(LABEL.claimed);
+}
+//# sourceMappingURL=labels.js.map

package/dist/ticket/labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.js","sourceRoot":"","sources":["../../src/ticket/labels.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,KAAK,EAAE,cAAc;IACrB,UAAU,EAAE,oBAAoB;IAChC,QAAQ,EAAE,aAAa;IACvB,OAAO,EAAE,YAAY;IACrB,SAAS,EAAE,YAAY;IACvB,aAAa,EAAE,gBAAgB;IAC/B,UAAU,EAAE,aAAa;IACzB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;IACpB,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,KAAK;IACV,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,gBAAgB;IAC1B,SAAS,EAAE,YAAY;IACvB,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;IACZ,EAAE,EAAE,aAAa;IACjB,EAAE,EAAE,aAAa;CACT,CAAC;AAEX,6CAA6C;AAC7C,MAAM,CAAC,MAAM,WAAW,GAAsB;IAC5C,SAAS;IACT,KAAK;IACL,OAAO;IACP,UAAU;IACV,OAAO;IACP,KAAK,CAAC,QAAQ;IACd,KAAK,CAAC,SAAS;IACf,KAAK,CAAC,IAAI;CACX,CAAC;AAEF,yEAAyE;AACzE,MAAM,CAAC,MAAM,cAAc,GAAsB;IAC/C,KAAK,CAAC,OAAO;IACb,KAAK,CAAC,MAAM;IACZ,KAAK,CAAC,SAAS;IACf,KAAK,CAAC,aAAa;IACnB,KAAK,CAAC,UAAU;IAChB,KAAK,CAAC,IAAI;CACX,CAAC;AAEF,MAAM,QAAQ,GAAG,sBAAsB,CAAC;AAExC,oFAAoF;AACpF,MAAM,UAAU,UAAU,CAAC,MAAyB;IAClD,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACxC,IAAI,KAAK,KAAK,SAAS;YAAE,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAyB;IACpD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,YAAY,CAAC,MAAyB;IACpD,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAC7E,CAAC"}

package/dist/ticket/payload.js

@@ -0,0 +1,37 @@
+import { priorityOf } from './labels.js';
+import { isTrusted } from './trust.js';
+/** `talos ticket status`'s JSON. */
+export const TICKET_SCHEMA = 'talos.ticket/1';
+/** What `talos ticket claim`, `next` and `release` print: the contract Thea's hub reads. */
+export const CLAIM_SCHEMA = 'talos.claim/1';
+const BODY_MAX = 3000;
+const COMMENT_MAX = 300;
+const LAST_COMMENTS = 5;
+export function clip(text, max) {
+    return text.length <= max ? text : `${text.slice(0, max - 1)}…`;
+}
+/**
+ * What a claim hands the agent: enough to start, small enough for its context. The body is the
+ * ticket's spec, so it is clipped far later than a message; the full text stays on GitHub. Each
+ * comment says whether its author is trusted, since anyone else's words are data.
+ */
+export function ticketPayload(issue, comments, who) {
+    const recent = comments.slice(-LAST_COMMENTS);
+    return {
+        number: issue.number,
+        title: issue.title,
+        labels: [...issue.labels],
+        priority: `p${priorityOf(issue.labels)}`,
+        author_association: issue.association ?? 'NONE',
+        body: clip(issue.body, BODY_MAX),
+        bodyTruncated: issue.body.length > BODY_MAX,
+        comments: recent.map((c) => ({
+            author: c.author ?? null,
+            trusted: isTrusted({ login: c.author, association: c.association }, who),
+            at: c.createdAt,
+            body: clip(c.body, COMMENT_MAX),
+        })),
+        commentsTotal: comments.length,
+    };
+}
+//# sourceMappingURL=payload.js.map

package/dist/ticket/payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.js","sourceRoot":"","sources":["../../src/ticket/payload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGvC,oCAAoC;AACpC,MAAM,CAAC,MAAM,aAAa,GAAG,gBAAgB,CAAC;AAE9C,4FAA4F;AAC5F,MAAM,CAAC,MAAM,YAAY,GAAG,eAAe,CAAC;AAE5C,MAAM,QAAQ,GAAG,IAAI,CAAC;AACtB,MAAM,WAAW,GAAG,GAAG,CAAC;AACxB,MAAM,aAAa,GAAG,CAAC,CAAC;AAExB,MAAM,UAAU,IAAI,CAAC,IAAY,EAAE,GAAW;IAC5C,OAAO,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC;AAClE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAY,EACZ,QAA4B,EAC5B,GAAe;IAEf,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,aAAa,CAAC,CAAC;IAC9C,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,MAAM,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;QACzB,QAAQ,EAAE,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE;QACxC,kBAAkB,EAAE,KAAK,CAAC,WAAW,IAAI,MAAM;QAC/C,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC;QAChC,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,QAAQ;QAC3C,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3B,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,IAAI;YACxB,OAAO,EAAE,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,GAAG,CAAC;YACxE,EAAE,EAAE,CAAC,CAAC,SAAS;YACf,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,WAAW,CAAC;SAChC,CAAC,CAAC;QACH,aAAa,EAAE,QAAQ,CAAC,MAAM;KAC/B,CAAC;AACJ,CAAC"}

package/dist/ticket/queue.js

@@ -0,0 +1,51 @@
+import { claim } from './claim.js';
+import { getIssue } from './github.js';
+import { LABEL, looksClaimed, priorityOf, CLAIM_BLOCKERS } from './labels.js';
+import { parseIssues } from './schemas.js';
+import { ticketBranches } from './stale.js';
+/** The claims held now: ticket branches whose issue is still open. */
+export async function openClaims(t) {
+    const claims = [];
+    for (const candidate of await ticketBranches(t.gh, t.repo, t.prefix)) {
+        const issue = await getIssue(t.gh, t.repo, candidate.issue);
+        if (issue !== undefined && !issue.isPull && issue.state === 'open')
+            claims.push(candidate);
+    }
+    return claims;
+}
+/** The queue `talos ticket next` works: claimable agent tickets by priority, then age. */
+export function queueOrder(issues) {
+    return issues
+        .filter((i) => !i.isPull &&
+        i.state === 'open' &&
+        i.labels.includes(LABEL.ready) &&
+        i.labels.includes(LABEL.eligible) &&
+        !looksClaimed(i.labels) &&
+        !CLAIM_BLOCKERS.some((label) => i.labels.includes(label)))
+        .sort((a, b) => priorityOf(a.labels) - priorityOf(b.labels) ||
+        Date.parse(a.createdAt) - Date.parse(b.createdAt) ||
+        a.number - b.number);
+}
+async function queue(t) {
+    const labels = [LABEL.ready, LABEL.eligible].map(encodeURIComponent).join(',');
+    const data = await t.gh.paginate(`repos/${t.repo}/issues?state=open&labels=${labels}`);
+    return queueOrder(parseIssues(data));
+}
+/**
+ * Claims the first ticket of the queue that can still be claimed, unless the repository's
+ * open claims already reach `agents.max_claims`. Losing a race moves on to the next ticket.
+ */
+export async function next(t, agent, maxClaims) {
+    const held = await openClaims(t);
+    if (held.length >= maxClaims) {
+        return { result: 'max-claims', claims: held.length, max: maxClaims };
+    }
+    const candidates = await queue(t);
+    for (const issue of candidates) {
+        const outcome = await claim(t, issue.number, agent);
+        if (outcome.result === 'claimed')
+            return { ...outcome, issue: issue.number };
+    }
+    return { result: 'empty', tried: candidates.length };
+}
+//# sourceMappingURL=queue.js.map

package/dist/ticket/queue.js.map

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