@on-par/factory-core 0.9.28-next.2 → 0.9.28-next.20

package/dist/queue/comment-rework-trigger.js

@@ -0,0 +1,128 @@
+// packages/core/src/queue/comment-rework-trigger.ts — a trusted `/factory rework <feedback>` PR comment queues a review rework on the same PR branch, once per comment id, counted against the review-rework cap (#3882, ADR-0128 trust).
+import { defaultFactoryConfig } from '@on-par/factory-config';
+import { countReviewReworkRuns, parkAtReviewReworkCap } from '../run/review-rework-cap.js';
+import { factoryBranchIssue } from '../utils/index.js';
+import { workKeyFromIssue } from '../work/work-key.js';
+import { isTrustedApprover } from './approval.js';
+import { IN_PROGRESS_LABEL, LANE_LABEL_PREFIX, PARKED_LABEL } from './github-queue.js';
+import { createEnqueuers } from './github-queue-enqueue.js';
+/** The feedback after `/factory rework` (rest of the first non-blank line plus later lines); null when the comment is not the command. */
+export function parseReworkCommand(body) {
+    const lines = body.split(/\r?\n/);
+    const at = lines.findIndex((line) => line.trim() !== '');
+    if (at < 0)
+        return null;
+    const match = /^\/factory rework(?:\s+|$)/i.exec((lines[at] ?? '').trim());
+    if (!match)
+        return null;
+    const first = (lines[at] ?? '').trim().slice(match[0].length);
+    return [first, ...lines.slice(at + 1)].join('\n').trim();
+}
+const errorMessage = (err) => (err instanceof Error ? err.message : String(err));
+async function pollPull(opts, pull, issue) {
+    const { github, queue, owner, repo, store } = opts;
+    const pending = (await github.listComments(pull.number)).filter((c) => parseReworkCommand(c.body) !== null && !store.has(c.id, 'comment'));
+    const trusted = [];
+    for (const comment of pending) {
+        const ok = await isTrustedApprover(comment.login, {
+            owner,
+            repo,
+            trustedApprovers: opts.trustedApprovers,
+            client: opts.permissions,
+        });
+        if (ok)
+            trusted.push(comment);
+    }
+    const newest = trusted.reduce((a, c) => (a === undefined || c.id > a.id ? c : a), undefined);
+    if (newest === undefined)
+        return null;
+    const reviewIds = trusted.map((c) => c.id);
+    const now = (opts.now ?? (() => new Date()))().toISOString();
+    const recordAll = (lane, extra) => {
+        for (const c of trusted) {
+            store.record({
+                reviewId: c.id,
+                source: 'comment',
+                pr: pull.number,
+                issue,
+                lane,
+                reviewer: c.login,
+                queuedAt: now,
+                ...extra,
+            });
+        }
+    };
+    const result = (outcome, extra = {}) => ({
+        pr: pull.number,
+        issue,
+        outcome,
+        reviewIds,
+        reviewer: newest.login,
+        ...extra,
+    });
+    if ((parseReworkCommand(newest.body) ?? '') === '') {
+        await github.postComment(pull.number, 'Factory rework: rejected — add the feedback after `/factory rework`.');
+        recordAll('', { cappedAt: now });
+        return result('skipped', { detail: 'no feedback' });
+    }
+    const labels = await queue.getIssueLabels({ owner, repo, issue_number: issue });
+    if (labels.includes(IN_PROGRESS_LABEL))
+        return result('skipped', { detail: 'claimed' });
+    if (labels.includes(PARKED_LABEL))
+        return result('skipped', { detail: 'parked' });
+    const lanes = labels.filter((l) => l.startsWith(LANE_LABEL_PREFIX)).map((l) => l.slice(LANE_LABEL_PREFIX.length));
+    if (lanes.length === 0)
+        return result('skipped', { detail: 'no lane label' });
+    if (lanes.length > 1)
+        return result('skipped', { detail: `several lane labels: ${lanes.join(', ')}` });
+    const lane = lanes[0] ?? '';
+    const cap = opts.maxRuns ?? defaultFactoryConfig.queue.max_review_rework_runs;
+    const key = workKeyFromIssue(issue);
+    const count = countReviewReworkRuns(store, key);
+    if (count >= cap) {
+        // Record first so a park that fails part-way is not commented on again by the next poll.
+        recordAll(lane, { cappedAt: now });
+        await parkAtReviewReworkCap({
+            queue,
+            owner,
+            repo,
+            issue: key,
+            pr: pull.number,
+            lane,
+            branch: pull.headRef,
+            cap,
+            count,
+            reviewIds,
+            source: 'comment',
+            publishComment: opts.publishParkComment,
+        });
+        await github.postComment(pull.number, `Factory rework: not queued — #${issue} has used its review-rework limit (${count}/${cap}, queue.max_review_rework_runs). The issue is parked.`);
+        return result('capped', { lane, cap, count });
+    }
+    const [res] = await createEnqueuers(queue, owner, repo).enqueue(lane, [issue]);
+    if (res === undefined || res.outcome === 'failed') {
+        return result('error', { lane, detail: res?.detail ?? 'enqueue returned nothing' });
+    }
+    recordAll(lane, {});
+    await github.postComment(pull.number, `Factory rework: queued #${issue} on lane '${lane}'. The next run reworks this comment's feedback on \`${pull.headRef}\` and pushes to this PR. No new PR is opened.`);
+    return result(res.outcome, { lane });
+}
+export async function pollCommentRework(opts) {
+    const results = [];
+    const pulls = await opts.github.listOpenPulls();
+    for (const pull of pulls) {
+        const issue = factoryBranchIssue(pull.headRef, opts.branchPrefix);
+        if (issue === null || pull.headRepo !== `${opts.owner}/${opts.repo}`)
+            continue;
+        try {
+            const result = await pollPull(opts, pull, issue);
+            if (result)
+                results.push(result);
+        }
+        catch (err) {
+            results.push({ pr: pull.number, issue, outcome: 'error', reviewIds: [], detail: errorMessage(err) });
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=comment-rework-trigger.js.map

package/dist/queue/comment-rework-trigger.js.map

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

package/dist/queue/internal-exports.d.ts

@@ -1,5 +1,7 @@
 export { createOctokitCollaboratorPermissionClient } from './approval.js';
 export { claimIterateCommand, createFileIterateStore, createOctokitIterateGitHub, pollIterateCommands, } from './iterate-command.js';
+export { parseReworkCommand, pollCommentRework } from './comment-rework-trigger.js';
+export type { ReviewReworkSource } from './review-rework-trigger.js';
 export { claimReviewRework, createFileReviewReworkStore, createOctokitReviewReworkGitHub, pollReviewRework, } from './review-rework-trigger.js';
 export * from '../run/review-rework-cap.js';
 export { allProvidersDown, allProvidersDownReleasePayload, PROVIDER_LEVEL_REASONS, stageBlocked, TIMED_BREAKER_REASONS, } from '../run/stage-blocked.js';

package/dist/queue/internal-exports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal-exports.d.ts","sourceRoot":"","sources":["../../src/queue/internal-exports.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yCAAyC,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,iBAAiB,EACjB,2BAA2B,EAC3B,+BAA+B,EAC/B,gBAAgB,GACjB,MAAM,4BAA4B,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,OAAO,EACL,gBAAgB,EAChB,8BAA8B,EAC9B,sBAAsB,EACtB,YAAY,EACZ,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACpF,YAAY,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7E,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"internal-exports.d.ts","sourceRoot":"","sources":["../../src/queue/internal-exports.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yCAAyC,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACpF,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EACL,iBAAiB,EACjB,2BAA2B,EAC3B,+BAA+B,EAC/B,gBAAgB,GACjB,MAAM,4BAA4B,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,OAAO,EACL,gBAAgB,EAChB,8BAA8B,EAC9B,sBAAsB,EACtB,YAAY,EACZ,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACpF,YAAY,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7E,cAAc,0BAA0B,CAAC"}

package/dist/queue/internal-exports.js

@@ -1,6 +1,7 @@
 // Review/approval queue exports re-exported from internal.ts (keeps that file under its max-lines ceiling)
 export { createOctokitCollaboratorPermissionClient } from './approval.js';
 export { claimIterateCommand, createFileIterateStore, createOctokitIterateGitHub, pollIterateCommands, } from './iterate-command.js';
+export { parseReworkCommand, pollCommentRework } from './comment-rework-trigger.js';
 export { claimReviewRework, createFileReviewReworkStore, createOctokitReviewReworkGitHub, pollReviewRework, } from './review-rework-trigger.js';
 export * from '../run/review-rework-cap.js';
 export { allProvidersDown, allProvidersDownReleasePayload, PROVIDER_LEVEL_REASONS, stageBlocked, TIMED_BREAKER_REASONS, } from '../run/stage-blocked.js';

package/dist/queue/internal-exports.js.map

@@ -1 +1 @@
-{"version":3,"file":"internal-exports.js","sourceRoot":"","sources":["../../src/queue/internal-exports.ts"],"names":[],"mappings":"AAAA,2GAA2G;AAC3G,OAAO,EAAE,yCAAyC,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,iBAAiB,EACjB,2BAA2B,EAC3B,+BAA+B,EAC/B,gBAAgB,GACjB,MAAM,4BAA4B,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,OAAO,EACL,gBAAgB,EAChB,8BAA8B,EAC9B,sBAAsB,EACtB,YAAY,EACZ,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AAGjC,cAAc,0BAA0B,CAAC,CAAC,wCAAwC"}
+{"version":3,"file":"internal-exports.js","sourceRoot":"","sources":["../../src/queue/internal-exports.ts"],"names":[],"mappings":"AAAA,2GAA2G;AAC3G,OAAO,EAAE,yCAAyC,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAEpF,OAAO,EACL,iBAAiB,EACjB,2BAA2B,EAC3B,+BAA+B,EAC/B,gBAAgB,GACjB,MAAM,4BAA4B,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,OAAO,EACL,gBAAgB,EAChB,8BAA8B,EAC9B,sBAAsB,EACtB,YAAY,EACZ,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AAGjC,cAAc,0BAA0B,CAAC,CAAC,wCAAwC"}

package/dist/queue/lane-discovery-interval.d.ts

@@ -0,0 +1,6 @@
+import type { FactoryConfig } from '../config/index.js';
+/** Default wait between lane-discovery passes in a running factory run (#3920). */
+export declare const DEFAULT_LANE_DISCOVERY_INTERVAL_MS = 60000;
+/** Milliseconds between lane-discovery passes, from validated config (#3920). */
+export declare function resolveLaneDiscoveryIntervalMs(config: Pick<FactoryConfig, 'queue'>): number;
+//# sourceMappingURL=lane-discovery-interval.d.ts.map

package/dist/queue/lane-discovery-interval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lane-discovery-interval.d.ts","sourceRoot":"","sources":["../../src/queue/lane-discovery-interval.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,mFAAmF;AACnF,eAAO,MAAM,kCAAkC,QAAS,CAAC;AAEzD,iFAAiF;AACjF,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,GAAG,MAAM,CAE3F"}

package/dist/queue/lane-discovery-interval.js

@@ -0,0 +1,9 @@
+// packages/core/src/queue/lane-discovery-interval.ts — how often a running `factory run` discovers new lanes (#3920).
+import { defaultFactoryConfig } from '@on-par/factory-config';
+/** Default wait between lane-discovery passes in a running factory run (#3920). */
+export const DEFAULT_LANE_DISCOVERY_INTERVAL_MS = 60_000;
+/** Milliseconds between lane-discovery passes, from validated config (#3920). */
+export function resolveLaneDiscoveryIntervalMs(config) {
+    return config.queue?.discovery_interval_ms ?? defaultFactoryConfig.queue.discovery_interval_ms;
+}
+//# sourceMappingURL=lane-discovery-interval.js.map

package/dist/queue/lane-discovery-interval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lane-discovery-interval.js","sourceRoot":"","sources":["../../src/queue/lane-discovery-interval.ts"],"names":[],"mappings":"AAAA,sHAAsH;AAEtH,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAI9D,mFAAmF;AACnF,MAAM,CAAC,MAAM,kCAAkC,GAAG,MAAM,CAAC;AAEzD,iFAAiF;AACjF,MAAM,UAAU,8BAA8B,CAAC,MAAoC;IACjF,OAAO,MAAM,CAAC,KAAK,EAAE,qBAAqB,IAAI,oBAAoB,CAAC,KAAK,CAAC,qBAAqB,CAAC;AACjG,CAAC"}

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

@@ -0,0 +1,17 @@
+import type { LinearTrackerConfig } from '../config/tracker-section.js';
+import { type LinearQueueClient } from './linear-queue.js';
+import { type LinearQueueLifecycleClient } from './linear-queue-lifecycle.js';
+import type { QueueBackend } from './queue-backend.js';
+export interface LinearQueueBackendOptions {
+    client: LinearQueueClient & LinearQueueLifecycleClient;
+    linear: LinearTrackerConfig;
+    warn: (msg: string) => void;
+    claimantId?: string;
+    leaseMs?: number;
+    now?: () => number;
+    defaultLane?: string;
+}
+/** The one `projects` key mapped to `ghRepo` (case-insensitive); null when none, throws when several. */
+export declare function resolveLinearProjectForRepo(linear: LinearTrackerConfig, ghRepo: string): string | null;
+export declare function createLinearQueueBackend(options: LinearQueueBackendOptions): QueueBackend;
+//# sourceMappingURL=linear-queue-backend.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"linear-queue-backend.d.ts","sourceRoot":"","sources":["../../src/queue/linear-queue-backend.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAExE,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAA8B,KAAK,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAC1G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,iBAAiB,GAAG,0BAA0B,CAAC;IACvD,MAAM,EAAE,mBAAmB,CAAC;IAC5B,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,yGAAyG;AACzG,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAStG;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,YAAY,CAyBzF"}

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

@@ -0,0 +1,42 @@
+import { defaultClaimantId } from './github-queue.js';
+import { createLinearQueue } from './linear-queue.js';
+import { createLinearQueueLifecycle } from './linear-queue-lifecycle.js';
+/** The one `projects` key mapped to `ghRepo` (case-insensitive); null when none, throws when several. */
+export function resolveLinearProjectForRepo(linear, ghRepo) {
+    const want = ghRepo.toLowerCase();
+    const matches = Object.entries(linear.projects)
+        .filter(([, repo]) => repo.toLowerCase() === want)
+        .map(([project]) => project);
+    if (matches.length > 1) {
+        throw new Error(`tracker.linear.projects maps ${ghRepo} from more than one project: ${matches.join(', ')}`);
+    }
+    return matches[0] ?? null;
+}
+export function createLinearQueueBackend(options) {
+    const { client, linear, warn } = options;
+    const claimantId = options.claimantId ?? defaultClaimantId();
+    const queue = createLinearQueue({ client, linear, claimantId, defaultLane: options.defaultLane });
+    const life = createLinearQueueLifecycle({
+        client,
+        linear,
+        warn,
+        claimantId,
+        leaseMs: options.leaseMs,
+        now: options.now,
+    });
+    return {
+        claimNext: async (lane) => {
+            const claim = await queue.claimNext(lane);
+            if (claim)
+                await life.heartbeat(claim.key);
+            return claim;
+        },
+        release: (key, outcome) => life.release(key, outcome),
+        heartbeat: life.heartbeat,
+        list: queue.list,
+        lanes: queue.lanes,
+        reap: life.reap,
+        pollBlockedParks: async () => [],
+    };
+}
+//# sourceMappingURL=linear-queue-backend.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"linear-queue-backend.js","sourceRoot":"","sources":["../../src/queue/linear-queue-backend.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAA0B,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAAE,0BAA0B,EAAmC,MAAM,6BAA6B,CAAC;AAa1G,yGAAyG;AACzG,MAAM,UAAU,2BAA2B,CAAC,MAA2B,EAAE,MAAc;IACrF,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IAClC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;SAC5C,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC;SACjD,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC;IAC/B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,gCAAgC,MAAM,gCAAgC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9G,CAAC;IACD,OAAO,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,OAAkC;IACzE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IACzC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,iBAAiB,EAAE,CAAC;IAC7D,MAAM,KAAK,GAAG,iBAAiB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAClG,MAAM,IAAI,GAAG,0BAA0B,CAAC;QACtC,MAAM;QACN,MAAM;QACN,IAAI;QACJ,UAAU;QACV,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB,CAAC,CAAC;IACH,OAAO;QACL,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACxB,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC1C,IAAI,KAAK;gBAAE,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC3C,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC;QACrD,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,gBAAgB,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE;KACjC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,62 @@
+import { type QueueReleaseOutcome } from './github-queue.js';
+import type { LinearTrackerConfig } from '../config/tracker-section.js';
+import { type WorkKey } from '../work/work-key.js';
+export declare const LINEAR_LEASE_KIND = "factory-claim-lease";
+export interface LinearClaimLease {
+    kind: typeof LINEAR_LEASE_KIND;
+    claimantId: string;
+    /** epoch ms */
+    expiresAt: number;
+}
+export interface LinearIssueLabelRef {
+    id: string;
+    name: string;
+}
+export interface LinearClaimedIssue {
+    id: string;
+    identifier: string;
+    labels: LinearIssueLabelRef[];
+    /** The factory-owned lease attachment, when present; metadata is untrusted. */
+    lease?: {
+        attachmentId: string;
+        metadata: unknown;
+    };
+}
+export interface LinearQueueLifecycleClient {
+    findIssue(identifier: string): Promise<LinearClaimedIssue | null>;
+    /** Every issue in the mapped project carrying a factory lease attachment. */
+    listLeasedIssues(): Promise<LinearClaimedIssue[]>;
+    ensureLabel(name: string): Promise<string>;
+    addLabel(issueId: string, labelId: string): Promise<void>;
+    removeLabel(issueId: string, labelId: string): Promise<void>;
+    moveToState(issueId: string, stateName: string): Promise<void>;
+    addComment(issueId: string, body: string): Promise<void>;
+    /** Creates or replaces the factory lease attachment on the issue with this metadata. */
+    upsertLeaseAttachment(issueId: string, lease: LinearClaimLease): Promise<void>;
+    deleteAttachment(attachmentId: string): Promise<void>;
+}
+export interface LinearStaleClaimRelease {
+    key: WorkKey;
+    claimantId: string;
+    expiresAt: number;
+    released: boolean;
+    outcome: 'released' | 'failed';
+    detail?: string;
+}
+export interface LinearQueueLifecycle {
+    release(key: WorkKey, outcome?: QueueReleaseOutcome, reason?: string): Promise<void>;
+    heartbeat(key: WorkKey): Promise<boolean>;
+    reap(): Promise<LinearStaleClaimRelease[]>;
+}
+export interface LinearQueueLifecycleOptions {
+    client: LinearQueueLifecycleClient;
+    linear: LinearTrackerConfig;
+    /** Receives one line per failed Linear write; required so a failure is never silent. */
+    warn: (msg: string) => void;
+    claimantId?: string;
+    leaseMs?: number;
+    now?: () => number;
+}
+export declare function parseLinearClaimLease(metadata: unknown): LinearClaimLease | null;
+export declare function createLinearQueueLifecycle(options: LinearQueueLifecycleOptions): LinearQueueLifecycle;
+//# sourceMappingURL=linear-queue-lifecycle.d.ts.map

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

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

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,51 @@
+import type { LinearTrackerConfig } from '../config/tracker-section.js';
+import type { QueueBackend } from './queue-backend.js';
+import type { LinearQueueLifecycleClient } from './linear-queue-lifecycle.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' | 'lanes'>;
+export interface LinearQueueOptions {
+    client: LinearQueueClient;
+    linear: LinearTrackerConfig;
+    claimantId?: string;
+    defaultLane?: string;
+}
+export declare const LINEAR_DEFAULT_LANE = "default";
+export declare const LINEAR_LEASE_ATTACHMENT_URL = "https://github.com/on-par/software-factory#claim-lease";
+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 & LinearQueueLifecycleClient;
+//# 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;AAC1E,OAAO,KAAK,EAAwC,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAGpH,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,GAAG,OAAO,CAAC,CAAC;AAC7E,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;AAC7C,eAAO,MAAM,2BAA2B,2DAA2D,CAAC;AAMpG,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,CA2C1E;AA0FD,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,GAAG,0BAA0B,CAwKjD"}