@on-par/factory-core 0.9.27 → 0.9.28-next.10

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":"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"}

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":"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"}

package/dist/run/pr-run-state.d.ts

@@ -0,0 +1,99 @@
+import type { Octokit } from '@octokit/rest';
+import type { RunStatus } from '../types/index.js';
+import { type WorkKey } from '../work/work-key.js';
+export declare const PR_RUN_STATE_VERSION = "v1";
+export declare const PR_RUN_STATUSES: readonly ['building', 'awaiting-ci', 'awaiting-review', 'parked'];
+export type PrRunStatus = (typeof PR_RUN_STATUSES)[number];
+export declare const SPEC_SUMMARY_MAX = 1000;
+export declare const MAX_HANDLED_IDS = 200;
+export declare const MAX_ROUNDS = 50;
+export declare const MAX_ENCODED_CHARS = 60000;
+export declare function prRunStateMarker(key: WorkKey): string;
+export interface PrRunRound {
+    kind: 'check' | 'review' | 'ci';
+    id?: number;
+    headSha: string;
+    at: string;
+}
+export interface PrRunState {
+    version: 1;
+    key: WorkKey;
+    prNumber: number;
+    status: PrRunStatus;
+    spec: {
+        sha256: string;
+        summary: string;
+    };
+    checkRework: {
+        used: number;
+        cap: number;
+    };
+    reviewRework: {
+        used: number;
+        cap: number;
+    };
+    handledReviewIds: number[];
+    handledCommentIds: number[];
+    rounds: PrRunRound[];
+    updatedAt: string;
+}
+export type PrRunStateRejectReason = 'untrusted-author' | 'digest-mismatch' | 'key-mismatch' | 'malformed' | 'identity-unavailable';
+export interface PrStateComment {
+    id: number;
+    authorId: number | undefined;
+    body: string;
+}
+type Ignored = {
+    commentId: number;
+    reason: PrRunStateRejectReason;
+}[];
+export type PrRunStateLoad = {
+    status: 'found';
+    commentId: number;
+    state: PrRunState;
+    ignored: Ignored;
+} | {
+    status: 'none';
+    ignored: Ignored;
+};
+/** Allow-list step: rebuilds the state from known fields only, redacts the summary and bounds every list. */
+export declare function sanitizePrRunState(state: PrRunState, maxIds?: number, maxRounds?: number): PrRunState;
+/** The hidden marker block for a state; halves rounds and handled ids until it fits one comment. */
+export declare function encodePrRunState(state: PrRunState): string;
+export declare function decodePrRunState(body: string, key: WorkKey): {
+    ok: true;
+    state: PrRunState;
+} | {
+    ok: false;
+    reason: PrRunStateRejectReason;
+} | null;
+/**
+ * Picks the state to trust: only a comment by `selfId` (the authenticated identity) is decoded. Lowest comment id
+ * wins, as in `readParkState`. An unknown identity fails closed: every marker comment is ignored.
+ */
+export declare function selectTrustedPrRunState(comments: readonly PrStateComment[], selfId: number | undefined, key: WorkKey): PrRunStateLoad;
+/**
+ * Monotonic merge of local and remote state. `used` counters take the max (a restore can only raise them, never
+ * reset a cap), `cap` comes from local because local config is current, handled ids and rounds are unioned (rounds
+ * deduped by kind+id+headSha, sorted by `at`), and `status`, `spec` and `prNumber` come from the side with the
+ * later `updatedAt`. One missing side returns the other.
+ */
+export declare function reconcilePrRunState(local: PrRunState | null, remote: PrRunState | null): PrRunState | null;
+export declare function prRunStatusFor(status: RunStatus, ciPending?: boolean): PrRunStatus;
+export declare function loadPrRunState(deps: {
+    octokit: Pick<Octokit, 'rest'>;
+    repo: string;
+    prNumber: number;
+    key: WorkKey;
+}): Promise<PrRunStateLoad>;
+export declare function savePrRunState(deps: {
+    octokit: Octokit;
+    repo: string;
+    prNumber: number;
+    state: PrRunState;
+}): Promise<{
+    commentId: number;
+    created: boolean;
+}>;
+export {};
+//# sourceMappingURL=pr-run-state.d.ts.map

package/dist/run/pr-run-state.d.ts.map

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