@urateam/core 0.1.0

package/dist/notifier/slack-alerts.d.ts

@@ -0,0 +1,62 @@
+import { Writable } from "node:stream";
+export interface AlertEntry {
+    level?: number;
+    component?: string;
+    issueId?: string;
+    runId?: string;
+    stage?: string;
+    msg?: string;
+    err?: {
+        message?: string;
+        stack?: string;
+    } | string;
+    [key: string]: unknown;
+}
+/**
+ * Manages rate-limited Slack error alerts.
+ *
+ * Watches pino log entries (level >= 50) and routes pipeline, PM Agent,
+ * auth, and git errors to a configured Slack channel via chat.postMessage.
+ *
+ * Duplicate errors (same component + message) are suppressed for 5 minutes
+ * to prevent alert fatigue.
+ */
+export declare class SlackAlertManager {
+    private readonly botToken;
+    private readonly channelId;
+    private readonly rateLimitMap;
+    constructor(botToken: string, channelId: string);
+    /**
+     * Process a single pino log entry. If the entry is at error level (>= 50)
+     * and passes the rate limiter, sends a Slack Block Kit alert.
+     * Fire-and-forget — never throws.
+     */
+    handleEntry(entry: AlertEntry): void;
+    private isRateLimited;
+    private markRateLimit;
+    private buildBlocks;
+    private send;
+}
+/**
+ * A Node.js Writable stream that parses pino JSON log lines and forwards
+ * error-level entries to a SlackAlertManager. Intended to be used with
+ * addLogStream() from logger.ts.
+ */
+export declare class SlackAlertStream extends Writable {
+    private readonly manager;
+    constructor(manager: SlackAlertManager);
+    _write(chunk: Buffer, _enc: BufferEncoding, callback: () => void): void;
+}
+/**
+ * Initialise the global SlackAlertManager singleton.
+ * Call this once at startup when SLACK_ERROR_ALERTS=true.
+ */
+export declare function initSlackAlertManager(botToken: string, channelId: string): SlackAlertManager;
+/** Returns the active singleton, or null if not initialised. */
+export declare function getSlackAlertManager(): SlackAlertManager | null;
+/**
+ * Create a pino-compatible Writable stream for the given manager.
+ * Wire this up with addLogStream() from logger.ts.
+ */
+export declare function createSlackAlertStream(manager: SlackAlertManager): SlackAlertStream;
+//# sourceMappingURL=slack-alerts.d.ts.map

package/dist/notifier/slack-alerts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-alerts.d.ts","sourceRoot":"","sources":["../../src/notifier/slack-alerts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AASvC,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC;IACpD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,qBAAa,iBAAiB;IAI1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAJ5B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;gBAGvC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM;IAGpC;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IA6BpC,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,WAAW;YAmEL,IAAI;CAcnB;AAED;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,QAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,iBAAiB;IAIvD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;CAYxE;AAMD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,iBAAiB,CAGnB;AAED,gEAAgE;AAChE,wBAAgB,oBAAoB,IAAI,iBAAiB,GAAG,IAAI,CAE/D;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,iBAAiB,GACzB,gBAAgB,CAElB"}

package/dist/notifier/slack-alerts.js

@@ -0,0 +1,184 @@
+import { Writable } from "node:stream";
+/** Escape characters that are active in Slack mrkdwn to prevent injection. */
+function escapeSlackMrkdwn(s) {
+    return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+const RATE_LIMIT_MS = 5 * 60 * 1000; // 5 minutes
+/**
+ * Manages rate-limited Slack error alerts.
+ *
+ * Watches pino log entries (level >= 50) and routes pipeline, PM Agent,
+ * auth, and git errors to a configured Slack channel via chat.postMessage.
+ *
+ * Duplicate errors (same component + message) are suppressed for 5 minutes
+ * to prevent alert fatigue.
+ */
+export class SlackAlertManager {
+    botToken;
+    channelId;
+    rateLimitMap = new Map();
+    constructor(botToken, channelId) {
+        this.botToken = botToken;
+        this.channelId = channelId;
+    }
+    /**
+     * Process a single pino log entry. If the entry is at error level (>= 50)
+     * and passes the rate limiter, sends a Slack Block Kit alert.
+     * Fire-and-forget — never throws.
+     */
+    handleEntry(entry) {
+        if (typeof entry.level !== "number" || entry.level < 50)
+            return;
+        const component = entry.component;
+        const errObj = entry.err;
+        const errMessage = errObj && typeof errObj === "object" && "message" in errObj
+            ? errObj.message
+            : typeof errObj === "string"
+                ? errObj
+                : undefined;
+        const message = errMessage ?? entry.msg ?? "unknown error";
+        // Build dedup key: component + first 100 chars of error message
+        const dedupKey = `${component ?? "unknown"}:${message.slice(0, 100)}`;
+        if (this.isRateLimited(dedupKey))
+            return;
+        this.markRateLimit(dedupKey);
+        const blocks = this.buildBlocks(entry, message);
+        // Fire-and-forget. Errors are written to stderr directly (not pino)
+        // to avoid a feedback loop through the alert stream.
+        this.send(blocks).catch((e) => {
+            process.stderr.write(`[SlackAlerts] Failed to send alert: ${e}\n`);
+        });
+    }
+    // --- Private helpers ---
+    isRateLimited(key) {
+        const last = this.rateLimitMap.get(key);
+        if (last === undefined)
+            return false;
+        if (Date.now() - last >= RATE_LIMIT_MS) {
+            this.rateLimitMap.delete(key);
+            return false;
+        }
+        return true;
+    }
+    markRateLimit(key) {
+        this.rateLimitMap.set(key, Date.now());
+    }
+    buildBlocks(entry, errorMessage) {
+        const { component, issueId, runId, stage } = entry;
+        const lowerMsg = errorMessage.toLowerCase();
+        const isAuthError = lowerMsg.includes("401") ||
+            lowerMsg.includes("unauthorized") ||
+            lowerMsg.includes("authentication") ||
+            lowerMsg.includes("api key");
+        const isPmAgent = typeof component === "string" && component.startsWith("PmAgent");
+        const isGitError = component === "git" ||
+            lowerMsg.includes("git") ||
+            lowerMsg.includes("clone failed") ||
+            lowerMsg.includes("push failed");
+        const title = isAuthError
+            ? "🔑 Auth Error — Action Required"
+            : isPmAgent
+                ? "🤖 PM Agent Error"
+                : isGitError
+                    ? "🔧 Git Operation Failed"
+                    : "🚨 Pipeline Error";
+        const blocks = [
+            {
+                type: "header",
+                text: { type: "plain_text", text: title },
+            },
+            {
+                type: "section",
+                text: {
+                    type: "mrkdwn",
+                    text: `*Error:* ${escapeSlackMrkdwn(errorMessage)}`,
+                },
+            },
+        ];
+        if (isAuthError) {
+            blocks.push({
+                type: "section",
+                text: {
+                    type: "mrkdwn",
+                    text: "*Remediation:* Check that `ANTHROPIC_API_KEY` and `LINEAR_API_KEY` are valid and not expired.",
+                },
+            });
+        }
+        const contextParts = [];
+        if (issueId)
+            contextParts.push(`Issue: \`${escapeSlackMrkdwn(issueId)}\``);
+        if (runId && typeof runId === "string")
+            contextParts.push(`Run: \`${escapeSlackMrkdwn(runId.slice(0, 8))}\``);
+        if (stage)
+            contextParts.push(`Stage: \`${escapeSlackMrkdwn(stage)}\``);
+        if (component)
+            contextParts.push(`Component: \`${escapeSlackMrkdwn(component)}\``);
+        contextParts.push(`Time: ${new Date().toISOString()}`);
+        blocks.push({
+            type: "context",
+            elements: [{ type: "mrkdwn", text: contextParts.join(" | ") }],
+        });
+        return blocks;
+    }
+    async send(blocks) {
+        const resp = await fetch("https://slack.com/api/chat.postMessage", {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${this.botToken}`,
+            },
+            body: JSON.stringify({ channel: this.channelId, blocks }),
+        });
+        const data = (await resp.json());
+        if (!data?.ok) {
+            process.stderr.write(`[SlackAlerts] postMessage returned ok:false: ${data?.error}\n`);
+        }
+    }
+}
+/**
+ * A Node.js Writable stream that parses pino JSON log lines and forwards
+ * error-level entries to a SlackAlertManager. Intended to be used with
+ * addLogStream() from logger.ts.
+ */
+export class SlackAlertStream extends Writable {
+    manager;
+    constructor(manager) {
+        super();
+        this.manager = manager;
+    }
+    _write(chunk, _enc, callback) {
+        try {
+            const line = chunk.toString().trim();
+            if (line) {
+                const entry = JSON.parse(line);
+                this.manager.handleEntry(entry);
+            }
+        }
+        catch {
+            // Ignore malformed log lines
+        }
+        callback();
+    }
+}
+// --- Module-level singleton ---
+let _manager = null;
+/**
+ * Initialise the global SlackAlertManager singleton.
+ * Call this once at startup when SLACK_ERROR_ALERTS=true.
+ */
+export function initSlackAlertManager(botToken, channelId) {
+    _manager = new SlackAlertManager(botToken, channelId);
+    return _manager;
+}
+/** Returns the active singleton, or null if not initialised. */
+export function getSlackAlertManager() {
+    return _manager;
+}
+/**
+ * Create a pino-compatible Writable stream for the given manager.
+ * Wire this up with addLogStream() from logger.ts.
+ */
+export function createSlackAlertStream(manager) {
+    return new SlackAlertStream(manager);
+}
+//# sourceMappingURL=slack-alerts.js.map

package/dist/notifier/slack-alerts.js.map

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

package/dist/notifier/slack.d.ts

@@ -0,0 +1,14 @@
+import type { Notifier, PipelineRun, StageResult, PipelineResult, PipelineError, DailyTokenSummary } from "../types.js";
+export declare class SlackNotifier implements Notifier {
+    private webhookUrl?;
+    constructor(webhookUrl?: string | undefined);
+    onPipelineStart(run: PipelineRun): Promise<void>;
+    onStageComplete(run: PipelineRun, stage: string, result: StageResult): Promise<void>;
+    onPipelineComplete(run: PipelineRun, result: PipelineResult): Promise<void>;
+    onHumanReviewNeeded(run: PipelineRun, prUrl: string, reason: string): Promise<void>;
+    onPipelineFailed(run: PipelineRun, error: PipelineError): Promise<void>;
+    onTokenBudgetAlert(run: PipelineRun, usedTokens: number, maxTokens: number): Promise<void>;
+    onDailyTokenSummary(summary: DailyTokenSummary): Promise<void>;
+    private send;
+}
+//# sourceMappingURL=slack.d.ts.map

package/dist/notifier/slack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack.d.ts","sourceRoot":"","sources":["../../src/notifier/slack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAKxH,qBAAa,aAAc,YAAW,QAAQ;IAChC,OAAO,CAAC,UAAU,CAAC;gBAAX,UAAU,CAAC,EAAE,MAAM,YAAA;IAEjC,eAAe,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAYhD,eAAe,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAapF,kBAAkB,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB3E,mBAAmB,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBnF,gBAAgB,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAevE,kBAAkB,CAAC,GAAG,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B1F,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;YAuBtD,IAAI;CAYnB"}

package/dist/notifier/slack.js

@@ -0,0 +1,146 @@
+import { createLogger } from "../logger.js";
+const log = createLogger({ component: "SlackNotifier" });
+export class SlackNotifier {
+    webhookUrl;
+    constructor(webhookUrl) {
+        this.webhookUrl = webhookUrl;
+    }
+    async onPipelineStart(run) {
+        await this.send({
+            blocks: [{
+                    type: "section",
+                    text: {
+                        type: "mrkdwn",
+                        text: `🚀 *Pipeline started* — ${run.issueTitle}\nPipeline: \`${run.pipelineKey}\` | Branch: \`${run.branch}\``,
+                    },
+                }],
+        });
+    }
+    async onStageComplete(run, stage, result) {
+        const emoji = result.status === "completed" ? "✅" : "❌";
+        let text = `${emoji} *Stage complete: ${stage}* — ${run.issueTitle}\n`;
+        text += `Status: ${result.status} | Tokens: ${result.inputTokens.toLocaleString()} in / ${result.outputTokens.toLocaleString()} out`;
+        await this.send({
+            blocks: [{
+                    type: "section",
+                    text: { type: "mrkdwn", text },
+                }],
+        });
+    }
+    async onPipelineComplete(run, result) {
+        const emoji = result.autoMerged ? "🎉" : "✅";
+        let text = `${emoji} *Pipeline complete* — ${run.issueTitle}\n`;
+        text += `Stages: ${result.stagesCompleted} | Tokens: ${result.totalInputTokens.toLocaleString()} in / ${result.totalOutputTokens.toLocaleString()} out`;
+        if (result.prUrl) {
+            text += `\n<${result.prUrl}|View PR>`;
+        }
+        if (result.autoMerged) {
+            text += `\n✅ Auto-merged to main`;
+        }
+        await this.send({
+            blocks: [{
+                    type: "section",
+                    text: { type: "mrkdwn", text },
+                }],
+        });
+    }
+    async onHumanReviewNeeded(run, prUrl, reason) {
+        await this.send({
+            blocks: [
+                {
+                    type: "header",
+                    text: { type: "plain_text", text: "👀 Human Review Needed" },
+                },
+                {
+                    type: "section",
+                    text: {
+                        type: "mrkdwn",
+                        text: `*${run.issueTitle}*\n<${prUrl}|View PR>\n\n*Reason:* ${reason}`,
+                    },
+                },
+                {
+                    type: "context",
+                    elements: [{
+                            type: "mrkdwn",
+                            text: `Pipeline: \`${run.pipelineKey}\` | Run: \`${run.id.slice(0, 8)}\``,
+                        }],
+                },
+            ],
+        });
+    }
+    async onPipelineFailed(run, error) {
+        let text = `❌ *Pipeline failed* — ${run.issueTitle}\n`;
+        text += `Stage: ${error.stage} | Error: ${error.message}`;
+        if (error.retriesExhausted) {
+            text += `\nRetries exhausted`;
+        }
+        await this.send({
+            blocks: [{
+                    type: "section",
+                    text: { type: "mrkdwn", text },
+                }],
+        });
+    }
+    async onTokenBudgetAlert(run, usedTokens, maxTokens) {
+        const pct = Math.round((usedTokens / maxTokens) * 100);
+        await this.send({
+            blocks: [
+                {
+                    type: "header",
+                    text: { type: "plain_text", text: "⚠️ Token Budget Alert" },
+                },
+                {
+                    type: "section",
+                    text: {
+                        type: "mrkdwn",
+                        text: `*${run.issueTitle}*\nUsage: ${usedTokens.toLocaleString()} / ${maxTokens.toLocaleString()} tokens (${pct}%)`,
+                    },
+                },
+                {
+                    type: "context",
+                    elements: [{
+                            type: "mrkdwn",
+                            text: `Pipeline: \`${run.pipelineKey}\` | Run: \`${run.id.slice(0, 8)}\``,
+                        }],
+                },
+            ],
+        });
+    }
+    async onDailyTokenSummary(summary) {
+        const totalTokens = summary.totalInputTokens + summary.totalOutputTokens;
+        await this.send({
+            blocks: [
+                {
+                    type: "header",
+                    text: { type: "plain_text", text: `📊 Daily Token Summary — ${summary.date}` },
+                },
+                {
+                    type: "section",
+                    text: {
+                        type: "mrkdwn",
+                        text: [
+                            `*Total tokens*: ${totalTokens.toLocaleString()} (${summary.totalInputTokens.toLocaleString()} in / ${summary.totalOutputTokens.toLocaleString()} out)`,
+                            `*Runs completed*: ${summary.runsCompleted}`,
+                            `*Runs failed*: ${summary.runsFailed}`,
+                        ].join("\n"),
+                    },
+                },
+            ],
+        });
+    }
+    async send(payload) {
+        if (!this.webhookUrl)
+            return;
+        try {
+            await fetch(this.webhookUrl, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify(payload),
+            });
+        }
+        catch (e) {
+            log.error({ err: e }, "Slack notification failed");
+        }
+    }
+}
+//# sourceMappingURL=slack.js.map

package/dist/notifier/slack.js.map

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

package/dist/pipeline/automerge.d.ts

@@ -0,0 +1,44 @@
+/**
+ * PR automerge eligibility checker and merger.
+ *
+ * Invoked by the GitHub webhook handler when a PR-related event is received
+ * (check_suite.completed, status, pull_request.labeled, etc.).
+ *
+ * All configured criteria must pass before a merge is attempted.  If branch
+ * protection rules would prevent the merge, GitHub's 405 response is caught
+ * and surfaced as a non-eligible reason rather than an error.
+ */
+import type { Octokit } from "@octokit/rest";
+export interface AutomergeOptions {
+    /** Minimum number of unique approving reviews required. Default: 0. */
+    minimumApprovingReviews?: number;
+    /** Status/check-run context names that must all report "success". Default: []. */
+    requiredStatusChecks?: string[];
+    /** Labels the PR must carry — all listed labels must be present. Default: []. */
+    requiredLabels?: string[];
+    /** Base branches the PR is allowed to target. Empty = any branch. Default: []. */
+    allowedBranches?: string[];
+    /** Merge method. Default: "squash". */
+    mergeMethod?: "merge" | "squash" | "rebase";
+}
+export interface AutomergeCheckResult {
+    eligible: boolean;
+    reason: string;
+}
+export interface AutomergeResult {
+    merged: boolean;
+    /** Human-readable outcome, e.g. "PR auto-merged" or "Branch protection prevented merge". */
+    message: string;
+}
+/**
+ * Check whether a PR satisfies all configured automerge criteria using the
+ * GitHub API.  Returns { eligible: true } only when every criterion passes.
+ */
+export declare function checkAutoMergeEligibility(octokit: Octokit, owner: string, repo: string, prNumber: number, options: AutomergeOptions): Promise<AutomergeCheckResult>;
+/**
+ * Attempt to merge a PR after verifying eligibility.  Returns a result
+ * object describing the outcome.  Does NOT throw — all errors are surfaced
+ * as non-merged results so callers can log/notify without crashing.
+ */
+export declare function attemptAutoMerge(octokit: Octokit, owner: string, repo: string, prNumber: number, options: AutomergeOptions): Promise<AutomergeResult>;
+//# sourceMappingURL=automerge.d.ts.map

package/dist/pipeline/automerge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"automerge.d.ts","sourceRoot":"","sources":["../../src/pipeline/automerge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAc7C,MAAM,WAAW,gBAAgB;IAC/B,uEAAuE;IACvE,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,kFAAkF;IAClF,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,iFAAiF;IACjF,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,kFAAkF;IAClF,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,uCAAuC;IACvC,WAAW,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;CAC7C;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,4FAA4F;IAC5F,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,oBAAoB,CAAC,CA8F/B;AAMD;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CAyB1B"}

package/dist/pipeline/automerge.js

@@ -0,0 +1,135 @@
+/**
+ * PR automerge eligibility checker and merger.
+ *
+ * Invoked by the GitHub webhook handler when a PR-related event is received
+ * (check_suite.completed, status, pull_request.labeled, etc.).
+ *
+ * All configured criteria must pass before a merge is attempted.  If branch
+ * protection rules would prevent the merge, GitHub's 405 response is caught
+ * and surfaced as a non-eligible reason rather than an error.
+ */
+import { getPRApprovalCount, getPRCheckResults, mergePRViaApi, } from "../repo/github.js";
+import { createLogger } from "../logger.js";
+const log = createLogger({ component: "automerge" });
+// ---------------------------------------------------------------------------
+// Eligibility check
+// ---------------------------------------------------------------------------
+/**
+ * Check whether a PR satisfies all configured automerge criteria using the
+ * GitHub API.  Returns { eligible: true } only when every criterion passes.
+ */
+export async function checkAutoMergeEligibility(octokit, owner, repo, prNumber, options) {
+    // Fetch PR details for draft/label/branch checks
+    let pr;
+    try {
+        const { data } = await octokit.pulls.get({
+            owner,
+            repo,
+            pull_number: prNumber,
+        });
+        pr = data;
+    }
+    catch (err) {
+        return { eligible: false, reason: `Failed to fetch PR details: ${err?.message ?? String(err)}` };
+    }
+    // Skip draft PRs
+    if (pr.draft) {
+        return { eligible: false, reason: "PR is a draft" };
+    }
+    // Skip already-merged PRs
+    if (pr.merged || pr.state === "closed") {
+        return { eligible: false, reason: "PR is already merged or closed" };
+    }
+    // Check allowed base branches
+    const allowedBranches = options.allowedBranches ?? [];
+    if (allowedBranches.length > 0 && !allowedBranches.includes(pr.base.ref)) {
+        return {
+            eligible: false,
+            reason: `Base branch '${pr.base.ref}' is not in allowedBranches: [${allowedBranches.join(", ")}]`,
+        };
+    }
+    // Check required labels
+    const requiredLabels = options.requiredLabels ?? [];
+    if (requiredLabels.length > 0) {
+        const prLabelNames = pr.labels.map((l) => l.name ?? "").filter(Boolean);
+        const missingLabels = requiredLabels.filter((l) => !prLabelNames.includes(l));
+        if (missingLabels.length > 0) {
+            return {
+                eligible: false,
+                reason: `PR is missing required labels: ${missingLabels.join(", ")}`,
+            };
+        }
+    }
+    // Check minimum approving reviews
+    const minApprovals = options.minimumApprovingReviews ?? 0;
+    if (minApprovals > 0) {
+        let approvalCount;
+        try {
+            approvalCount = await getPRApprovalCount(octokit, owner, repo, prNumber);
+        }
+        catch (err) {
+            return { eligible: false, reason: `Failed to fetch reviews: ${err?.message ?? String(err)}` };
+        }
+        if (approvalCount < minApprovals) {
+            return {
+                eligible: false,
+                reason: `PR has ${approvalCount} approving review(s), need ${minApprovals}`,
+            };
+        }
+    }
+    // Check required status checks
+    const requiredChecks = options.requiredStatusChecks ?? [];
+    if (requiredChecks.length > 0) {
+        let checkResults;
+        try {
+            checkResults = await getPRCheckResults(octokit, owner, repo, pr.head.sha);
+        }
+        catch (err) {
+            return { eligible: false, reason: `Failed to fetch status checks: ${err?.message ?? String(err)}` };
+        }
+        for (const checkName of requiredChecks) {
+            const conclusion = checkResults.get(checkName);
+            // "success" and "neutral" are both acceptable passing states
+            if (!conclusion || (conclusion !== "success" && conclusion !== "neutral")) {
+                return {
+                    eligible: false,
+                    reason: `Required status check '${checkName}' has not passed (status: ${conclusion ?? "not found"})`,
+                };
+            }
+        }
+    }
+    return { eligible: true, reason: "All automerge criteria met" };
+}
+// ---------------------------------------------------------------------------
+// Merge
+// ---------------------------------------------------------------------------
+/**
+ * Attempt to merge a PR after verifying eligibility.  Returns a result
+ * object describing the outcome.  Does NOT throw — all errors are surfaced
+ * as non-merged results so callers can log/notify without crashing.
+ */
+export async function attemptAutoMerge(octokit, owner, repo, prNumber, options) {
+    log.info({ owner, repo, prNumber }, "checking PR for automerge eligibility");
+    const eligibility = await checkAutoMergeEligibility(octokit, owner, repo, prNumber, options);
+    if (!eligibility.eligible) {
+        log.info({ owner, repo, prNumber, reason: eligibility.reason }, "PR not eligible for automerge");
+        return { merged: false, message: eligibility.reason };
+    }
+    const mergeMethod = options.mergeMethod ?? "squash";
+    log.info({ owner, repo, prNumber, mergeMethod }, "PR eligible — attempting automerge");
+    try {
+        const result = await mergePRViaApi(octokit, owner, repo, prNumber, mergeMethod);
+        if (result.merged) {
+            log.info({ owner, repo, prNumber }, "PR auto-merged successfully");
+            return { merged: true, message: "PR auto-merged successfully" };
+        }
+        log.warn({ owner, repo, prNumber, message: result.message }, "automerge API call failed");
+        return { merged: false, message: result.message };
+    }
+    catch (err) {
+        const message = err?.message ?? String(err);
+        log.error({ err, owner, repo, prNumber }, "automerge threw an unexpected error");
+        return { merged: false, message: `Automerge error: ${message}` };
+    }
+}
+//# sourceMappingURL=automerge.js.map

package/dist/pipeline/automerge.js.map

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

package/dist/pipeline/config.d.ts

@@ -0,0 +1,5 @@
+import type { PipelineConfig, RepoConfig } from "../types.js";
+export declare const defaultConfigs: Record<string, PipelineConfig>;
+export declare function validatePipelineConfigs(configs: Record<string, unknown>): Record<string, PipelineConfig>;
+export declare function validateRepoConfigs(configs: Record<string, unknown>): Record<string, RepoConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/pipeline/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/pipeline/config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAa9D,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAiCzD,CAAC;AAEF,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAYhC;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAY5B"}