@on-par/factory-core 0.9.28-next.1 → 0.9.28-next.11

package/dist/queue/linear-queue-lifecycle.js

@@ -0,0 +1,139 @@
+// packages/core/src/queue/linear-queue-lifecycle.ts — Linear queue release, park, lease heartbeat and reap (ADR-0173, #3893).
+import { z } from 'zod';
+import { claimedByLabel, DEFAULT_CLAIM_LEASE_MS, defaultClaimantId, PARKED_LABEL, } from './github-queue.js';
+import { toWorkKey } from '../work/work-key.js';
+export const LINEAR_LEASE_KIND = 'factory-claim-lease';
+const LeaseSchema = z.object({
+    kind: z.literal(LINEAR_LEASE_KIND),
+    claimantId: z.string().min(1),
+    expiresAt: z.number(),
+});
+export function parseLinearClaimLease(metadata) {
+    const parsed = LeaseSchema.safeParse(metadata);
+    return parsed.success ? parsed.data : null;
+}
+function messageOf(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+export function createLinearQueueLifecycle(options) {
+    const { client, linear, warn } = options;
+    const claimantId = options.claimantId ?? defaultClaimantId();
+    const leaseMs = options.leaseMs ?? DEFAULT_CLAIM_LEASE_MS;
+    const now = options.now ?? Date.now;
+    const me = claimedByLabel(claimantId);
+    let lastError;
+    async function attempt(op, identifier, fn) {
+        try {
+            await fn();
+            return true;
+        }
+        catch (err) {
+            lastError = messageOf(err);
+            warn(`linear queue: ${op} on ${identifier} failed: ${lastError}`);
+            return false;
+        }
+    }
+    async function freeClaim(issue, claimLabel, leaseAttachmentId) {
+        let ok = true;
+        const label = issue.labels.find((l) => l.name === claimLabel);
+        if (label)
+            ok = (await attempt('claim label removal', issue.identifier, () => client.removeLabel(issue.id, label.id))) && ok;
+        if (leaseAttachmentId !== undefined) {
+            ok = (await attempt('lease removal', issue.identifier, () => client.deleteAttachment(leaseAttachmentId))) && ok;
+        }
+        return ok;
+    }
+    async function release(key, outcome = 'queued', reason) {
+        let issue;
+        try {
+            issue = await client.findIssue(key);
+        }
+        catch (err) {
+            warn(`linear queue: release of ${key}: lookup failed: ${messageOf(err)}`);
+            return;
+        }
+        if (!issue) {
+            warn(`linear queue: release of ${key}: issue not found`);
+            return;
+        }
+        const target = issue;
+        const ownLease = parseLinearClaimLease(target.lease?.metadata)?.claimantId === claimantId;
+        const hasLabel = target.labels.some((l) => l.name === me);
+        if (!ownLease && !hasLabel)
+            return;
+        await freeClaim(target, me, ownLease ? target.lease?.attachmentId : undefined);
+        switch (outcome) {
+            case 'queued':
+                await attempt('move to ready', key, () => client.moveToState(target.id, linear.states.ready));
+                break;
+            case 'parked': {
+                await attempt('parked label', key, async () => {
+                    const labelId = await client.ensureLabel(PARKED_LABEL);
+                    await client.addLabel(target.id, labelId);
+                });
+                const body = reason?.trim() ? `Parked by the factory: ${reason}` : 'Parked by the factory (no reason given).';
+                await attempt('park comment', key, () => client.addComment(target.id, body));
+                await attempt('move to parked', key, () => client.moveToState(target.id, linear.states.parked));
+                break;
+            }
+            case 'done':
+                break;
+            default: {
+                const _never = outcome;
+                return _never;
+            }
+        }
+    }
+    async function heartbeat(key) {
+        let issue;
+        try {
+            issue = await client.findIssue(key);
+        }
+        catch (err) {
+            warn(`linear queue: heartbeat of ${key}: lookup failed: ${messageOf(err)}`);
+            return true;
+        }
+        if (!issue || !issue.labels.some((l) => l.name === me))
+            return false;
+        const target = issue;
+        await attempt('lease renew', key, () => client.upsertLeaseAttachment(target.id, { kind: LINEAR_LEASE_KIND, claimantId, expiresAt: now() + leaseMs }));
+        return true;
+    }
+    async function reap() {
+        let issues;
+        try {
+            issues = await client.listLeasedIssues();
+        }
+        catch (err) {
+            warn(`linear queue: reap listing failed: ${messageOf(err)}`);
+            return [];
+        }
+        const rows = [];
+        for (const issue of issues) {
+            if (!issue.lease)
+                continue;
+            const lease = parseLinearClaimLease(issue.lease.metadata);
+            if (!lease) {
+                warn(`linear queue: reap of ${issue.identifier}: malformed lease attachment`);
+                continue;
+            }
+            if (lease.expiresAt > now())
+                continue;
+            lastError = undefined;
+            const freed = await freeClaim(issue, claimedByLabel(lease.claimantId), issue.lease.attachmentId);
+            const moved = await attempt('move to ready', issue.identifier, () => client.moveToState(issue.id, linear.states.ready));
+            const ok = freed && moved;
+            rows.push({
+                key: toWorkKey(issue.identifier),
+                claimantId: lease.claimantId,
+                expiresAt: lease.expiresAt,
+                released: ok,
+                outcome: ok ? 'released' : 'failed',
+                ...(ok ? {} : { detail: lastError }),
+            });
+        }
+        return rows;
+    }
+    return { release, heartbeat, reap };
+}
+//# sourceMappingURL=linear-queue-lifecycle.js.map

package/dist/queue/linear-queue-lifecycle.js.map

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

package/dist/queue/linear-queue.d.ts

@@ -0,0 +1,49 @@
+import type { LinearTrackerConfig } from '../config/tracker-section.js';
+import type { QueueBackend } from './queue-backend.js';
+export interface LinearQueueLabel {
+    id: string;
+    name: string;
+    /** Parent label (group) name. */
+    group?: string;
+}
+export interface LinearQueueIssue {
+    id: string;
+    identifier: string;
+    priority: number;
+    createdAt: string;
+    stateType: string;
+    labels: LinearQueueLabel[];
+}
+export interface LinearQueueClient {
+    /** Issues in the mapped project, in the ready state, carrying the ready label. Rejects on any API error. */
+    listCandidates(): Promise<LinearQueueIssue[]>;
+    /** Fresh label names on one issue. */
+    issueLabels(issueId: string): Promise<string[]>;
+    /** Id of the team label `name`, creating it when missing. */
+    ensureLabel(name: string): Promise<string>;
+    addLabel(issueId: string, labelId: string): Promise<void>;
+    removeLabel(issueId: string, labelId: string): Promise<void>;
+    /** Moves the issue to the team workflow state named `stateName`. */
+    moveToState(issueId: string, stateName: string): Promise<void>;
+}
+export type LinearQueue = Pick<QueueBackend, 'list' | 'claimNext'>;
+export interface LinearQueueOptions {
+    client: LinearQueueClient;
+    linear: LinearTrackerConfig;
+    claimantId?: string;
+    defaultLane?: string;
+}
+export declare const LINEAR_DEFAULT_LANE = "default";
+export declare function isLinearCandidate(issue: LinearQueueIssue, readyLabel: string): boolean;
+export declare function linearLaneOf(issue: LinearQueueIssue, laneLabelGroup: string, defaultLane?: string): string;
+export declare function compareLinearCandidates(a: LinearQueueIssue, b: LinearQueueIssue): number;
+export declare function createLinearQueue(options: LinearQueueOptions): LinearQueue;
+export declare function createLinearQueueGraphqlClient(opts: {
+    apiKey: string;
+    linear: LinearTrackerConfig;
+    project: string;
+    fetch?: typeof globalThis.fetch;
+    endpoint?: string;
+    timeoutMs?: number;
+}): LinearQueueClient;
+//# sourceMappingURL=linear-queue.d.ts.map

package/dist/queue/linear-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear-queue.d.ts","sourceRoot":"","sources":["../../src/queue/linear-queue.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAGxE,OAAO,KAAK,EAAE,YAAY,EAAqB,MAAM,oBAAoB,CAAC;AAG1E,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AACD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AACD,MAAM,WAAW,iBAAiB;IAChC,4GAA4G;IAC5G,cAAc,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC9C,sCAAsC;IACtC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAChD,6DAA6D;IAC7D,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,oEAAoE;IACpE,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChE;AACD,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC;AACnE,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,MAAM,EAAE,mBAAmB,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,mBAAmB,YAAY,CAAC;AAK7C,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAQtF;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,gBAAgB,EACvB,cAAc,EAAE,MAAM,EACtB,WAAW,GAAE,MAA4B,GACxC,MAAM,CAER;AAaD,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAYxF;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAsC1E;AA+DD,wBAAgB,8BAA8B,CAAC,IAAI,EAAE;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,mBAAmB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,iBAAiB,CAqHpB"}

package/dist/queue/linear-queue.js

@@ -0,0 +1,258 @@
+// packages/core/src/queue/linear-queue.ts — Linear-backed queue seam: list and claimNext (ADR-0173, #3892).
+import { z } from 'zod';
+import { LinearApiError } from '../work/linear-client.js';
+import { claimedByLabel, CLAIMED_BY_LABEL_PREFIX, defaultClaimantId, PARKED_LABEL } from './github-queue.js';
+import { QUEUE_ORDER_LABEL_PREFIX } from './queue-order.js';
+import { toWorkKey } from '../work/work-key.js';
+export const LINEAR_DEFAULT_LANE = 'default';
+const EXCLUDED_STATE_TYPES = new Set(['started', 'completed', 'canceled']);
+const ORDER_PATTERN = new RegExp(`^${QUEUE_ORDER_LABEL_PREFIX}(\\d+)$`);
+export function isLinearCandidate(issue, readyLabel) {
+    if (EXCLUDED_STATE_TYPES.has(issue.stateType))
+        return false;
+    const names = issue.labels.map((l) => l.name);
+    return (names.some((n) => n === readyLabel) &&
+        !names.some((n) => n.startsWith(CLAIMED_BY_LABEL_PREFIX)) &&
+        !names.includes(PARKED_LABEL));
+}
+export function linearLaneOf(issue, laneLabelGroup, defaultLane = LINEAR_DEFAULT_LANE) {
+    return issue.labels.find((l) => l.group === laneLabelGroup)?.name ?? defaultLane;
+}
+function priorityRank(p) {
+    return p >= 1 && p <= 4 ? p : 5;
+}
+function orderOf(issue) {
+    const matches = issue.labels.map((l) => ORDER_PATTERN.exec(l.name)).filter((m) => m !== null);
+    if (matches.length !== 1)
+        return Number.POSITIVE_INFINITY;
+    const n = Number(matches[0]?.[1]);
+    return Number.isSafeInteger(n) && n > 0 ? n : Number.POSITIVE_INFINITY;
+}
+export function compareLinearCandidates(a, b) {
+    const pa = priorityRank(a.priority);
+    const pb = priorityRank(b.priority);
+    if (pa !== pb)
+        return pa - pb;
+    const oa = orderOf(a);
+    const ob = orderOf(b);
+    if (oa < ob)
+        return -1;
+    if (oa > ob)
+        return 1;
+    const ca = Date.parse(a.createdAt);
+    const cb = Date.parse(b.createdAt);
+    if (ca !== cb)
+        return ca - cb;
+    return a.identifier.localeCompare(b.identifier);
+}
+export function createLinearQueue(options) {
+    const { client, linear } = options;
+    const defaultLane = options.defaultLane ?? LINEAR_DEFAULT_LANE;
+    const claimantId = options.claimantId ?? defaultClaimantId();
+    const myLabel = claimedByLabel(claimantId);
+    let myLabelId;
+    async function sortedFor(lane) {
+        const issues = await client.listCandidates();
+        const laneOf = (i) => linearLaneOf(i, linear.laneLabelGroup, defaultLane);
+        const eligible = issues.filter((i) => isLinearCandidate(i, linear.readyLabel) && (lane === undefined || laneOf(i) === lane));
+        if (lane !== undefined)
+            return eligible.sort(compareLinearCandidates);
+        return eligible.sort((a, b) => laneOf(a).localeCompare(laneOf(b)) || compareLinearCandidates(a, b));
+    }
+    async function list(lane) {
+        return (await sortedFor(lane)).map((i) => toWorkKey(i.identifier));
+    }
+    async function claimNext(lane) {
+        const candidates = await sortedFor(lane);
+        if (candidates.length === 0)
+            return null;
+        myLabelId ??= await client.ensureLabel(myLabel);
+        for (const c of candidates) {
+            await client.addLabel(c.id, myLabelId);
+            await client.moveToState(c.id, linear.states.inProgress);
+            const after = await client.issueLabels(c.id);
+            const winner = after.filter((n) => n.startsWith(CLAIMED_BY_LABEL_PREFIX)).sort()[0];
+            if (winner === myLabel)
+                return { key: toWorkKey(c.identifier), decision: { kind: 'build' } };
+            // The winner owns In Progress, so the state is left alone.
+            if (after.includes(myLabel))
+                await client.removeLabel(c.id, myLabelId);
+        }
+        return null;
+    }
+    return { list, claimNext };
+}
+const MAX_PAGES = 10;
+const ENVELOPE = z.object({
+    data: z.unknown().nullish(),
+    errors: z.array(z.object({ message: z.string() })).optional(),
+});
+const CANDIDATES_QUERY = `query($after: String, $team: String!, $project: String!, $ready: String!, $label: String!) {
+  issues(first: 100, after: $after, filter: { team: { key: { eq: $team } }, project: { or: [{ name: { eq: $project } }, { id: { eq: $project } }] }, state: { name: { eq: $ready } }, labels: { some: { name: { eq: $label } } } }) {
+    nodes { id identifier priority createdAt state { type } labels { nodes { id name parent { name } } } }
+    pageInfo { hasNextPage endCursor }
+  }
+}`;
+const TEAM_QUERY = `query($team: String!) { teams(filter: { key: { eq: $team } }) { nodes { id states { nodes { id name } } } } }`;
+const FIND_LABEL_QUERY = `query($name: String!, $teamId: ID!) { issueLabels(filter: { name: { eq: $name }, team: { id: { eq: $teamId } } }) { nodes { id } } }`;
+const CREATE_LABEL_MUTATION = `mutation($name: String!, $teamId: String!) { issueLabelCreate(input: { name: $name, teamId: $teamId }) { success issueLabel { id } } }`;
+const ADD_LABEL_MUTATION = `mutation($id: String!, $labelId: String!) { issueAddLabel(id: $id, labelId: $labelId) { success } }`;
+const REMOVE_LABEL_MUTATION = `mutation($id: String!, $labelId: String!) { issueRemoveLabel(id: $id, labelId: $labelId) { success } }`;
+const UPDATE_STATE_MUTATION = `mutation($id: String!, $stateId: String!) { issueUpdate(id: $id, input: { stateId: $stateId }) { success } }`;
+const ISSUE_LABELS_QUERY = `query($id: String!) { issue(id: $id) { labels { nodes { name } } } }`;
+const CandidatesSchema = z.object({
+    issues: z.object({
+        nodes: z.array(z.object({
+            id: z.string(),
+            identifier: z.string(),
+            priority: z.number(),
+            createdAt: z.string(),
+            state: z.object({ type: z.string() }),
+            labels: z.object({
+                nodes: z.array(z.object({ id: z.string(), name: z.string(), parent: z.object({ name: z.string() }).nullish() })),
+            }),
+        })),
+        pageInfo: z.object({ hasNextPage: z.boolean(), endCursor: z.string().nullish() }),
+    }),
+});
+const TeamSchema = z.object({
+    teams: z.object({
+        nodes: z.array(z.object({
+            id: z.string(),
+            states: z.object({ nodes: z.array(z.object({ id: z.string(), name: z.string() })) }),
+        })),
+    }),
+});
+const FindLabelSchema = z.object({ issueLabels: z.object({ nodes: z.array(z.object({ id: z.string() })) }) });
+const CreateLabelSchema = z.object({
+    issueLabelCreate: z.object({ success: z.boolean(), issueLabel: z.object({ id: z.string() }).nullish() }),
+});
+const AddLabelSchema = z.object({ issueAddLabel: z.object({ success: z.boolean() }) });
+const RemoveLabelSchema = z.object({ issueRemoveLabel: z.object({ success: z.boolean() }) });
+const UpdateSchema = z.object({ issueUpdate: z.object({ success: z.boolean() }) });
+const IssueLabelsSchema = z.object({
+    issue: z.object({ labels: z.object({ nodes: z.array(z.object({ name: z.string() })) }) }).nullable(),
+});
+export function createLinearQueueGraphqlClient(opts) {
+    const { apiKey, linear, project } = opts;
+    const fetchImpl = opts.fetch ?? globalThis.fetch;
+    const endpoint = opts.endpoint ?? 'https://api.linear.app/graphql';
+    const redact = (text) => text.split(apiKey).join('***');
+    async function request(query, variables, schema) {
+        let res;
+        let json;
+        try {
+            res = await fetchImpl(endpoint, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json', Authorization: apiKey },
+                body: JSON.stringify({ query, variables }),
+                signal: AbortSignal.timeout(opts.timeoutMs ?? 30_000),
+            });
+            if (!res.ok)
+                throw new LinearApiError(`Linear API returned HTTP ${res.status}`);
+            json = await res.json();
+        }
+        catch (err) {
+            if (err instanceof LinearApiError)
+                throw err;
+            throw new LinearApiError(redact(err instanceof Error ? err.message : String(err)));
+        }
+        const envelope = ENVELOPE.safeParse(json);
+        if (!envelope.success)
+            throw malformed(envelope.error);
+        const { data, errors } = envelope.data;
+        if (errors && errors.length > 0) {
+            throw new LinearApiError(redact(`Linear API error: ${errors.map((e) => e.message).join('; ')}`));
+        }
+        if (data == null)
+            throw new LinearApiError('Linear API returned no data');
+        const parsed = schema.safeParse(data);
+        if (!parsed.success)
+            throw malformed(parsed.error);
+        return parsed.data;
+    }
+    function malformed(error) {
+        const first = error.issues[0];
+        const where = first ? `${first.path.join('.')}: ${first.message}` : 'unknown';
+        return new LinearApiError(redact(`malformed Linear response: ${where}`));
+    }
+    let team;
+    function teamInfo() {
+        team ??= request(TEAM_QUERY, { team: linear.teamKey }, TeamSchema).then((d) => {
+            const found = d.teams.nodes[0];
+            if (!found)
+                throw new LinearApiError(`Linear team ${linear.teamKey} not found`);
+            return found;
+        });
+        team.catch(() => {
+            team = undefined;
+        });
+        return team;
+    }
+    function ensureSuccess(ok, what) {
+        if (!ok)
+            throw new LinearApiError(`Linear ${what} reported success=false`);
+    }
+    return {
+        async listCandidates() {
+            const out = [];
+            let after = null;
+            for (let page = 0; page < MAX_PAGES; page++) {
+                const { issues } = await request(CANDIDATES_QUERY, { after, team: linear.teamKey, project, ready: linear.states.ready, label: linear.readyLabel }, CandidatesSchema);
+                for (const n of issues.nodes) {
+                    out.push({
+                        id: n.id,
+                        identifier: n.identifier,
+                        priority: n.priority,
+                        createdAt: n.createdAt,
+                        stateType: n.state.type,
+                        labels: n.labels.nodes.map((l) => ({
+                            id: l.id,
+                            name: l.name,
+                            ...(l.parent ? { group: l.parent.name } : {}),
+                        })),
+                    });
+                }
+                if (!issues.pageInfo.hasNextPage)
+                    return out;
+                after = issues.pageInfo.endCursor ?? null;
+            }
+            throw new LinearApiError('Linear ready queue exceeds 1000 issues');
+        },
+        async issueLabels(issueId) {
+            const d = await request(ISSUE_LABELS_QUERY, { id: issueId }, IssueLabelsSchema);
+            if (d.issue === null)
+                throw new LinearApiError(`Linear issue ${issueId} not found`);
+            return d.issue.labels.nodes.map((l) => l.name);
+        },
+        async ensureLabel(name) {
+            const { id: teamId } = await teamInfo();
+            const found = await request(FIND_LABEL_QUERY, { name, teamId }, FindLabelSchema);
+            const existing = found.issueLabels.nodes[0];
+            if (existing)
+                return existing.id;
+            const created = (await request(CREATE_LABEL_MUTATION, { name, teamId }, CreateLabelSchema)).issueLabelCreate;
+            ensureSuccess(created.success, 'label create');
+            if (!created.issueLabel)
+                throw new LinearApiError('Linear label create returned no label');
+            return created.issueLabel.id;
+        },
+        async addLabel(issueId, labelId) {
+            const d = await request(ADD_LABEL_MUTATION, { id: issueId, labelId }, AddLabelSchema);
+            ensureSuccess(d.issueAddLabel.success, 'label add');
+        },
+        async removeLabel(issueId, labelId) {
+            const d = await request(REMOVE_LABEL_MUTATION, { id: issueId, labelId }, RemoveLabelSchema);
+            ensureSuccess(d.issueRemoveLabel.success, 'label remove');
+        },
+        async moveToState(issueId, stateName) {
+            const info = await teamInfo();
+            const state = info.states.nodes.find((s) => s.name === stateName);
+            if (!state)
+                throw new LinearApiError(`Linear state "${stateName}" not found in team ${linear.teamKey}`);
+            const d = await request(UPDATE_STATE_MUTATION, { id: issueId, stateId: state.id }, UpdateSchema);
+            ensureSuccess(d.issueUpdate.success, 'state update');
+        },
+    };
+}
+//# sourceMappingURL=linear-queue.js.map

package/dist/queue/linear-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear-queue.js","sourceRoot":"","sources":["../../src/queue/linear-queue.ts"],"names":[],"mappings":"AAAA,4GAA4G;AAE5G,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC7G,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,OAAO,EAAE,SAAS,EAAgB,MAAM,qBAAqB,CAAC;AAoC9D,MAAM,CAAC,MAAM,mBAAmB,GAAG,SAAS,CAAC;AAE7C,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC;AAC3E,MAAM,aAAa,GAAG,IAAI,MAAM,CAAC,IAAI,wBAAwB,SAAS,CAAC,CAAC;AAExE,MAAM,UAAU,iBAAiB,CAAC,KAAuB,EAAE,UAAkB;IAC3E,IAAI,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5D,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC9C,OAAO,CACL,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,UAAU,CAAC;QACnC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC;QACzD,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,CAC9B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,KAAuB,EACvB,cAAsB,EACtB,WAAW,GAAW,mBAAmB;IAEzC,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,cAAc,CAAC,EAAE,IAAI,IAAI,WAAW,CAAC;AACnF,CAAC;AAED,SAAS,YAAY,CAAC,CAAS;IAC7B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,OAAO,CAAC,KAAuB;IACtC,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IAC9F,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,iBAAiB,CAAC;IAC1D,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAClC,OAAO,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,CAAmB,EAAE,CAAmB;IAC9E,MAAM,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACpC,MAAM,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACpC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,EAAE,GAAG,EAAE,CAAC;IAC9B,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACtB,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACtB,IAAI,EAAE,GAAG,EAAE;QAAE,OAAO,CAAC,CAAC,CAAC;IACvB,IAAI,EAAE,GAAG,EAAE;QAAE,OAAO,CAAC,CAAC;IACtB,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACnC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACnC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,EAAE,GAAG,EAAE,CAAC;IAC9B,OAAO,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAA2B;IAC3D,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IACnC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,mBAAmB,CAAC;IAC/D,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,iBAAiB,EAAE,CAAC;IAC7D,MAAM,OAAO,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAC3C,IAAI,SAA6B,CAAC;IAElC,KAAK,UAAU,SAAS,CAAC,IAAa;QACpC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,cAAc,EAAE,CAAC;QAC7C,MAAM,MAAM,GAAG,CAAC,CAAmB,EAAU,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;QACpG,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAC5B,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAC7F,CAAC;QACF,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,QAAQ,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QACtE,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,uBAAuB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACtG,CAAC;IAED,KAAK,UAAU,IAAI,CAAC,IAAa;QAC/B,OAAO,CAAC,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,UAAU,SAAS,CAAC,IAAY;QACnC,MAAM,UAAU,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACzC,SAAS,KAAK,MAAM,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAChD,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;YAC3B,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;YACvC,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YACzD,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC7C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACpF,IAAI,MAAM,KAAK,OAAO;gBAAE,OAAO,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC;YAC7F,2DAA2D;YAC3D,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAAE,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QACzE,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,SAAS,GAAG,EAAE,CAAC;AAErB,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;IACxB,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE;IAC3B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC9D,CAAC,CAAC;AAEH,MAAM,gBAAgB,GAAG;;;;;EAKvB,CAAC;AACH,MAAM,UAAU,GAAG,+GAA+G,CAAC;AACnI,MAAM,gBAAgB,GAAG,sIAAsI,CAAC;AAChK,MAAM,qBAAqB,GAAG,wIAAwI,CAAC;AACvK,MAAM,kBAAkB,GAAG,qGAAqG,CAAC;AACjI,MAAM,qBAAqB,GAAG,wGAAwG,CAAC;AACvI,MAAM,qBAAqB,GAAG,8GAA8G,CAAC;AAC7I,MAAM,kBAAkB,GAAG,sEAAsE,CAAC;AAElG,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,KAAK,EAAE,CAAC,CAAC,KAAK,CACZ,CAAC,CAAC,MAAM,CAAC;YACP,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;YACd,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;YACtB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;YACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;YACrB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;YACrC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;gBACf,KAAK,EAAE,CAAC,CAAC,KAAK,CACZ,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CACjG;aACF,CAAC;SACH,CAAC,CACH;QACD,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC;KAClF,CAAC;CACH,CAAC,CAAC;AACH,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1B,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,KAAK,EAAE,CAAC,CAAC,KAAK,CACZ,CAAC,CAAC,MAAM,CAAC;YACP,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;YACd,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;SACrF,CAAC,CACH;KACF,CAAC;CACH,CAAC,CAAC;AACH,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;AAC9G,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,gBAAgB,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;CACzG,CAAC,CAAC;AACH,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;AACvF,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;AAC7F,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;AACnF,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;CACrG,CAAC,CAAC;AAEH,MAAM,UAAU,8BAA8B,CAAC,IAO9C;IACC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACzC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC;IACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,gCAAgC,CAAC;IACnE,MAAM,MAAM,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAExE,KAAK,UAAU,OAAO,CAAI,KAAa,EAAE,SAAkC,EAAE,MAAoB;QAC/F,IAAI,GAAa,CAAC;QAClB,IAAI,IAAa,CAAC;QAClB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,SAAS,CAAC,QAAQ,EAAE;gBAC9B,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,EAAE;gBACtE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;gBAC1C,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC;aACtD,CAAC,CAAC;YACH,IAAI,CAAC,GAAG,CAAC,EAAE;gBAAE,MAAM,IAAI,cAAc,CAAC,4BAA4B,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;YAChF,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC1B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,cAAc;gBAAE,MAAM,GAAG,CAAC;YAC7C,MAAM,IAAI,cAAc,CAAC,MAAM,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACrF,CAAC;QACD,MAAM,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,QAAQ,CAAC,OAAO;YAAE,MAAM,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACvD,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC;QACvC,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,cAAc,CAAC,MAAM,CAAC,qBAAqB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACnG,CAAC;QACD,IAAI,IAAI,IAAI,IAAI;YAAE,MAAM,IAAI,cAAc,CAAC,6BAA6B,CAAC,CAAC;QAC1E,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,MAAM,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnD,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,SAAS,SAAS,CAAC,KAAiB;QAClC,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9E,OAAO,IAAI,cAAc,CAAC,MAAM,CAAC,8BAA8B,KAAK,EAAE,CAAC,CAAC,CAAC;IAC3E,CAAC;IAED,IAAI,IAA+E,CAAC;IACpF,SAAS,QAAQ;QACf,IAAI,KAAK,OAAO,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;YAC5E,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC/B,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,cAAc,CAAC,eAAe,MAAM,CAAC,OAAO,YAAY,CAAC,CAAC;YAChF,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE;YACd,IAAI,GAAG,SAAS,CAAC;QACnB,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAED,SAAS,aAAa,CAAC,EAAW,EAAE,IAAY;QAC9C,IAAI,CAAC,EAAE;YAAE,MAAM,IAAI,cAAc,CAAC,UAAU,IAAI,yBAAyB,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO;QACL,KAAK,CAAC,cAAc;YAClB,MAAM,GAAG,GAAuB,EAAE,CAAC;YACnC,IAAI,KAAK,GAAkB,IAAqB,CAAC;YACjD,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC;gBAC5C,MAAM,EAAE,MAAM,EAAE,GAAqC,MAAM,OAAO,CAChE,gBAAgB,EAChB,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,EAC9F,gBAAgB,CACjB,CAAC;gBACF,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;oBAC7B,GAAG,CAAC,IAAI,CAAC;wBACP,EAAE,EAAE,CAAC,CAAC,EAAE;wBACR,UAAU,EAAE,CAAC,CAAC,UAAU;wBACxB,QAAQ,EAAE,CAAC,CAAC,QAAQ;wBACpB,SAAS,EAAE,CAAC,CAAC,SAAS;wBACtB,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI;wBACvB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;4BACjC,EAAE,EAAE,CAAC,CAAC,EAAE;4BACR,IAAI,EAAE,CAAC,CAAC,IAAI;4BACZ,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;yBAC9C,CAAC,CAAC;qBACJ,CAAC,CAAC;gBACL,CAAC;gBACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW;oBAAE,OAAO,GAAG,CAAC;gBAC7C,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,IAAI,IAAI,CAAC;YAC5C,CAAC;YACD,MAAM,IAAI,cAAc,CAAC,wCAAwC,CAAC,CAAC;QACrE,CAAC;QACD,KAAK,CAAC,WAAW,CAAC,OAAO;YACvB,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,kBAAkB,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,iBAAiB,CAAC,CAAC;YAChF,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI;gBAAE,MAAM,IAAI,cAAc,CAAC,gBAAgB,OAAO,YAAY,CAAC,CAAC;YACpF,OAAO,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACjD,CAAC;QACD,KAAK,CAAC,WAAW,CAAC,IAAI;YACpB,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,MAAM,QAAQ,EAAE,CAAC;YACxC,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,gBAAgB,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC;YACjF,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC5C,IAAI,QAAQ;gBAAE,OAAO,QAAQ,CAAC,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,qBAAqB,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC,gBAAgB,CAAC;YAC7G,aAAa,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;YAC/C,IAAI,CAAC,OAAO,CAAC,UAAU;gBAAE,MAAM,IAAI,cAAc,CAAC,uCAAuC,CAAC,CAAC;YAC3F,OAAO,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,CAAC;QACD,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO;YAC7B,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,kBAAkB,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,cAAc,CAAC,CAAC;YACtF,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QACtD,CAAC;QACD,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO;YAChC,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,qBAAqB,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,iBAAiB,CAAC,CAAC;YAC5F,aAAa,CAAC,CAAC,CAAC,gBAAgB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAC5D,CAAC;QACD,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,SAAS;YAClC,MAAM,IAAI,GAAG,MAAM,QAAQ,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;YAClE,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,cAAc,CAAC,iBAAiB,SAAS,uBAAuB,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YACxG,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,qBAAqB,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,EAAE,YAAY,CAAC,CAAC;YACjG,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QACvD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/queue/queue-backend.d.ts

@@ -1,13 +1,22 @@
 import { type BlockedParkPollResult, type BlockedParkStore } from '../blockers/poller.js';
 import { type GithubQueueOptions, type QueueClaim, type QueueReleaseOutcome } from './github-queue.js';
+import { type WorkKey } from '../work/work-key.js';
 import { type StaleClaimRelease } from './stale-claims.js';
+export interface QueueBackendClaim {
+    key: WorkKey;
+    decision: QueueClaim['decision'];
+}
 export interface QueueBackend {
-    /** Claims and returns the next eligible issue in `lane`, or null when none is eligible. */
-    claimNext(lane: string): Promise<QueueClaim | null>;
-    /** Releases a previously claimed issue back to the queue with the given outcome (default 'queued'). */
-    release(issue: number, outcome?: QueueReleaseOutcome): Promise<void>;
-    /** Queued issue numbers for one lane, in claim order; every lane, lane-sorted, when `lane` is omitted. */
-    list(lane?: string): Promise<number[]>;
+    /** Claims and returns the next eligible work item in `lane`, or null when none is eligible. */
+    claimNext(lane: string): Promise<QueueBackendClaim | null>;
+    /** Releases a previously claimed work item back to the queue with the given outcome (default 'queued'). */
+    release(key: WorkKey, outcome?: QueueReleaseOutcome): Promise<void>;
+    /** Refreshes this claimant's lease; false when the claim is gone (GithubQueue.heartbeat semantics). */
+    heartbeat(key: WorkKey): Promise<boolean>;
+    /** Queued work keys for one lane, in claim order; every lane, lane-sorted, when `lane` is omitted. */
+    list(lane?: string): Promise<WorkKey[]>;
+    /** Lane names that currently have queued work. */
+    lanes(): Promise<string[]>;
     /** Detects and releases claims whose TTL lease has expired across the whole queue. */
     reap(): Promise<StaleClaimRelease[]>;
     /** Unparks `blocked` parents whose blockers resolved (#2318); [] when no blockedParks store was configured. */
@@ -17,4 +26,14 @@ export type GithubQueueBackendOptions = GithubQueueOptions & {
     blockedParks?: BlockedParkStore;
 };
 export declare function createGithubQueueBackend(options: GithubQueueBackendOptions): QueueBackend;
+export type QueueBackendKind = 'github';
+export interface QueueBackendOptions {
+    kind: QueueBackendKind;
+    github: GithubQueueBackendOptions;
+}
+export declare class UnsupportedQueueBackendError extends Error {
+    readonly kind: string;
+    constructor(kind: string);
+}
+export declare function createQueueBackend(options: QueueBackendOptions): QueueBackend;
 //# sourceMappingURL=queue-backend.d.ts.map

package/dist/queue/queue-backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queue-backend.d.ts","sourceRoot":"","sources":["../../src/queue/queue-backend.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,qBAAqB,EAAE,KAAK,gBAAgB,EAAoB,MAAM,uBAAuB,CAAC;AAC5G,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,UAAU,EACf,KAAK,mBAAmB,EACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAsB,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE/E,MAAM,WAAW,YAAY;IAC3B,2FAA2F;IAC3F,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACpD,uGAAuG;IACvG,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,0GAA0G;IAC1G,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACvC,sFAAsF;IACtF,IAAI,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACrC,+GAA+G;IAC/G,gBAAgB,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAAC;CACtD;AAED,MAAM,MAAM,yBAAyB,GAAG,kBAAkB,GAAG;IAAE,YAAY,CAAC,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAEjG,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,YAAY,CAuBzF"}
+{"version":3,"file":"queue-backend.d.ts","sourceRoot":"","sources":["../../src/queue/queue-backend.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,qBAAqB,EAAE,KAAK,gBAAgB,EAAoB,MAAM,uBAAuB,CAAC;AAC5G,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,UAAU,EACf,KAAK,mBAAmB,EACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAmC,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACpF,OAAO,EAAsB,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE/E,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,OAAO,CAAC;IACb,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,YAAY;IAC3B,+FAA+F;IAC/F,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAC3D,2GAA2G;IAC3G,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,uGAAuG;IACvG,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1C,sGAAsG;IACtG,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACxC,kDAAkD;IAClD,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3B,sFAAsF;IACtF,IAAI,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACrC,+GAA+G;IAC/G,gBAAgB,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAAC;CACtD;AAED,MAAM,MAAM,yBAAyB,GAAG,kBAAkB,GAAG;IAAE,YAAY,CAAC,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAEjG,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,YAAY,CAoCzF;AAED,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AAExC,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,EAAE,yBAAyB,CAAC;CACnC;AAED,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,YAAY,IAAI,EAAE,MAAM,EAIvB;CACF;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAO7E"}

package/dist/queue/queue-backend.js

@@ -1,18 +1,23 @@
-// packages/core/src/queue/queue-backend.ts — Backend-agnostic queue seam; GitHub-labels is today's only implementation (#1499).
+// packages/core/src/queue/queue-backend.ts — Backend-agnostic queue seam speaking WorkKey; GitHub-labels is today's only implementation (#1499, #3890).
 import { pollBlockedParks } from '../blockers/poller.js';
 import { createGithubQueue, } from './github-queue.js';
+import { issueNumberOf, workKeyFromIssue } from '../work/work-key.js';
 import { releaseStaleClaims } from './stale-claims.js';
 export function createGithubQueueBackend(options) {
     const { client, owner, repo, now } = options;
     const queue = createGithubQueue(options);
+    async function claimNext(lane) {
+        const claim = await queue.claimNext(lane);
+        return claim === null ? null : { key: workKeyFromIssue(claim.issue), decision: claim.decision };
+    }
     async function list(lane) {
         if (lane !== undefined)
-            return queue.list(lane);
-        const issues = [];
+            return (await queue.list(lane)).map(workKeyFromIssue);
+        const keys = [];
         for (const l of await queue.lanes()) {
-            issues.push(...(await queue.list(l)));
+            keys.push(...(await queue.list(l)).map(workKeyFromIssue));
         }
-        return issues;
+        return keys;
     }
     async function reap() {
         return releaseStaleClaims({ client, owner, repo, now });
@@ -22,6 +27,30 @@ export function createGithubQueueBackend(options) {
             return [];
         return pollBlockedParks({ client, owner, repo, store: options.blockedParks });
     }
-    return { claimNext: queue.claimNext, release: queue.release, list, reap, pollBlockedParks: pollParks };
+    return {
+        claimNext,
+        release: async (key, outcome) => queue.release(issueNumberOf(key), outcome),
+        heartbeat: async (key) => queue.heartbeat(issueNumberOf(key)),
+        list,
+        lanes: () => queue.lanes(),
+        reap,
+        pollBlockedParks: pollParks,
+    };
+}
+export class UnsupportedQueueBackendError extends Error {
+    kind;
+    constructor(kind) {
+        super(`unsupported queue backend "${kind}" — supported: github`);
+        this.name = 'UnsupportedQueueBackendError';
+        this.kind = kind;
+    }
+}
+export function createQueueBackend(options) {
+    switch (options.kind) {
+        case 'github':
+            return createGithubQueueBackend(options.github);
+        default:
+            throw new UnsupportedQueueBackendError(String(options.kind));
+    }
 }
 //# sourceMappingURL=queue-backend.js.map

package/dist/queue/queue-backend.js.map

@@ -1 +1 @@
-{"version":3,"file":"queue-backend.js","sourceRoot":"","sources":["../../src/queue/queue-backend.ts"],"names":[],"mappings":"AAAA,gIAAgI;AAEhI,OAAO,EAAqD,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC5G,OAAO,EACL,iBAAiB,GAIlB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAA0B,MAAM,mBAAmB,CAAC;AAiB/E,MAAM,UAAU,wBAAwB,CAAC,OAAkC;IACzE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;IAC7C,MAAM,KAAK,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAEzC,KAAK,UAAU,IAAI,CAAC,IAAa;QAC/B,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,KAAK,MAAM,CAAC,IAAI,MAAM,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;YACpC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,UAAU,IAAI;QACjB,OAAO,kBAAkB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,UAAU,SAAS;QACtB,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS;YAAE,OAAO,EAAE,CAAC;QAClD,OAAO,gBAAgB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE,SAAS,EAAE,CAAC;AACzG,CAAC"}
+{"version":3,"file":"queue-backend.js","sourceRoot":"","sources":["../../src/queue/queue-backend.ts"],"names":[],"mappings":"AAAA,wJAAwJ;AAExJ,OAAO,EAAqD,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC5G,OAAO,EACL,iBAAiB,GAIlB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAgB,MAAM,qBAAqB,CAAC;AACpF,OAAO,EAAE,kBAAkB,EAA0B,MAAM,mBAAmB,CAAC;AA0B/E,MAAM,UAAU,wBAAwB,CAAC,OAAkC;IACzE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;IAC7C,MAAM,KAAK,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAEzC,KAAK,UAAU,SAAS,CAAC,IAAY;QACnC,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC1C,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;IAClG,CAAC;IAED,KAAK,UAAU,IAAI,CAAC,IAAa;QAC/B,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAC9E,MAAM,IAAI,GAAc,EAAE,CAAC;QAC3B,KAAK,MAAM,CAAC,IAAI,MAAM,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;YACpC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,UAAU,IAAI;QACjB,OAAO,kBAAkB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,UAAU,SAAS;QACtB,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS;YAAE,OAAO,EAAE,CAAC;QAClD,OAAO,gBAAgB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,OAAO;QACL,SAAS;QACT,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;QAC3E,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QAC7D,IAAI;QACJ,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE;QAC1B,IAAI;QACJ,gBAAgB,EAAE,SAAS;KAC5B,CAAC;AACJ,CAAC;AASD,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IAC5C,IAAI,CAAS;IAEtB,YAAY,IAAY;QACtB,KAAK,CAAC,8BAA8B,IAAI,uBAAuB,CAAC,CAAC;QACjE,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;QAC3C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,UAAU,kBAAkB,CAAC,OAA4B;IAC7D,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,QAAQ;YACX,OAAO,wBAAwB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClD;YACE,MAAM,IAAI,4BAA4B,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACjE,CAAC;AACH,CAAC"}

package/dist/queue/review-rework-trigger.d.ts

@@ -19,8 +19,13 @@ export interface ReviewReworkGitHub {
     /** Reviews in GitHub's chronological order. */
     listReviews(pr: number): Promise<ReviewReworkReview[]>;
 }
+/** What triggered a rework: a formal review, or a `/factory rework` PR comment (#3882). */
+export type ReviewReworkSource = 'review' | 'comment';
 export interface ReviewReworkRecord {
+    /** The GitHub review id, or the issue-comment id when `source` is `'comment'`. */
     reviewId: number;
+    /** Absent or `'review'` is a formal review (legacy files have no source). */
+    source?: ReviewReworkSource;
     pr: number;
     issue: number;
     lane: string;
@@ -32,11 +37,11 @@ export interface ReviewReworkRecord {
     cappedAt?: string;
 }
 export interface ReviewReworkStore {
-    has(reviewId: number): boolean;
+    has(reviewId: number, source?: ReviewReworkSource): boolean;
     record(entry: ReviewReworkRecord): void;
     list(): ReviewReworkRecord[];
     /** Stamp `startedAt` on a record; an unknown id does nothing. */
-    markStarted(reviewId: number, at: string): void;
+    markStarted(reviewId: number, at: string, source?: ReviewReworkSource): void;
 }
 export type ReviewReworkOutcome = 'queued' | 'already-queued' | 'capped' | 'skipped' | 'error';
 export interface ReviewReworkPollResult {