@urateam/core 0.1.0

package/dist/pipeline/config.js

@@ -0,0 +1,68 @@
+import { PipelineConfigSchema, RepoConfigSchema } from "../types.js";
+// Shared reduced-cost loop defaults applied to every built-in pipeline.
+// These can be overridden per-pipeline in your own config by setting explicit values.
+// To opt in to the previous (higher) values, set e.g. ralphIterations: 2 in your config.
+const LOOP_DEFAULTS = {
+    ralphIterations: 2, // RALPH gate: verify acceptance criteria after implement, retry once if gaps found
+    reviewFixIterations: 1, // single review-fix pass catches most blocking issues
+    deepReviewPasses: 0, // disabled by default; opt-in for critical pipelines
+    validateHandoffs: false, // disabled by default; opt-in per pipeline
+};
+// Default pipeline configs from the spec
+export const defaultConfigs = {
+    "auto-implement": {
+        ...LOOP_DEFAULTS,
+        name: "Auto Implement",
+        stages: ["implement", "test", "review"],
+        retry: { maxAttempts: 2, strategy: "fix-and-retry" },
+        review: { requiredApprovals: 1 },
+        prStrategy: "draft",
+    },
+    "bug": {
+        ...LOOP_DEFAULTS,
+        name: "Bug Fix",
+        stages: ["reproduce", "implement", "test", "review"],
+        retry: { maxAttempts: 3, strategy: "fix-and-retry" },
+        review: { requiredApprovals: 1 },
+        prStrategy: "draft",
+    },
+    "needs-design": {
+        ...LOOP_DEFAULTS,
+        name: "Needs Design",
+        stages: ["triage", "await-approval", "implement", "test", "review"],
+        retry: { maxAttempts: 1, strategy: "fail-fast" },
+        review: { requiredApprovals: 1 },
+        prStrategy: "draft",
+    },
+    "quick-fix": {
+        ...LOOP_DEFAULTS,
+        name: "Quick Fix",
+        stages: ["implement", "test"],
+        retry: { maxAttempts: 1, strategy: "escalate" },
+        review: { requiredApprovals: 0 },
+        prStrategy: "ready",
+    },
+};
+export function validatePipelineConfigs(configs) {
+    const validated = {};
+    for (const [key, value] of Object.entries(configs)) {
+        const result = PipelineConfigSchema.safeParse(value);
+        if (!result.success) {
+            throw new Error(`Invalid pipeline config "${key}": ${result.error.issues.map((i) => i.message).join(", ")}`);
+        }
+        validated[key] = result.data;
+    }
+    return validated;
+}
+export function validateRepoConfigs(configs) {
+    const validated = {};
+    for (const [key, value] of Object.entries(configs)) {
+        const result = RepoConfigSchema.safeParse(value);
+        if (!result.success) {
+            throw new Error(`Invalid repo config "${key}": ${result.error.issues.map((i) => i.message).join(", ")}`);
+        }
+        validated[key] = result.data;
+    }
+    return validated;
+}
+//# sourceMappingURL=config.js.map

package/dist/pipeline/config.js.map

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

package/dist/pipeline/distributed-lock.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Distributed branch lock — prevents simultaneous push+PR creation for the
+ * same branch across multiple server instances.
+ *
+ * Strategy:
+ *   - PostgreSQL: `pg_try_advisory_lock(hashtext(branch))` with a poll/retry
+ *     loop until the configurable timeout is reached.
+ *   - SQLite: no-op adapter (SQLite is single-process; the in-process pushQueue
+ *     already provides the necessary serialisation).
+ */
+import type { AnyDb } from "../db/client.js";
+export interface LockAdapter {
+    /** Attempt to acquire the lock for `key`. Returns true if acquired. */
+    tryAcquire(key: string): Promise<boolean>;
+    /** Release a previously acquired lock for `key`. */
+    release(key: string): Promise<void>;
+}
+export declare class LockTimeoutError extends Error {
+    constructor(key: string, timeoutMs: number);
+}
+/**
+ * No-op adapter used for SQLite (single-process deployments).
+ * The in-process pushQueue already serialises within a single process.
+ */
+export declare function createNoopLockAdapter(): LockAdapter;
+/**
+ * PostgreSQL advisory lock adapter.
+ * Uses session-level `pg_try_advisory_lock` so the lock is automatically
+ * freed if the connection drops unexpectedly.
+ */
+export declare function createPgLockAdapter(db: AnyDb): LockAdapter;
+/**
+ * Returns the appropriate lock adapter for the given database driver.
+ */
+export declare function createBranchLockAdapter(db: AnyDb): LockAdapter;
+/**
+ * Acquire a distributed lock keyed by `key`, run `fn`, then release the lock.
+ *
+ * - If the lock is not available, the function polls every ~250 ms until
+ *   `timeoutMs` elapses, then throws `LockTimeoutError`.
+ * - The lock is always released in a `finally` block — including when `fn`
+ *   throws — so deadlocks cannot occur due to application errors.
+ *
+ * @param adapter   Lock backend (Postgres advisory lock or no-op for SQLite)
+ * @param key       Unique lock key (typically the git branch name)
+ * @param timeoutMs Maximum time to wait for the lock before failing
+ * @param fn        Work to perform while the lock is held
+ */
+export declare function withBranchLock<T>(adapter: LockAdapter, key: string, timeoutMs: number, fn: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=distributed-lock.d.ts.map

package/dist/pipeline/distributed-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"distributed-lock.d.ts","sourceRoot":"","sources":["../../src/pipeline/distributed-lock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAS7C,MAAM,WAAW,WAAW;IAC1B,uEAAuE;IACvE,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1C,oDAAoD;IACpD,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAED,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAM3C;AAMD;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,WAAW,CAOnD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,KAAK,GAAG,WAAW,CA0B1D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,KAAK,GAAG,WAAW,CAK9D;AAQD;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CAAC,CAAC,EACpC,OAAO,EAAE,WAAW,EACpB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CA2BZ"}

package/dist/pipeline/distributed-lock.js

@@ -0,0 +1,114 @@
+/**
+ * Distributed branch lock — prevents simultaneous push+PR creation for the
+ * same branch across multiple server instances.
+ *
+ * Strategy:
+ *   - PostgreSQL: `pg_try_advisory_lock(hashtext(branch))` with a poll/retry
+ *     loop until the configurable timeout is reached.
+ *   - SQLite: no-op adapter (SQLite is single-process; the in-process pushQueue
+ *     already provides the necessary serialisation).
+ */
+import { sql } from "drizzle-orm";
+import { isPostgres } from "../db/client.js";
+import { createLogger } from "../logger.js";
+const log = createLogger({ component: "DistributedLock" });
+export class LockTimeoutError extends Error {
+    constructor(key, timeoutMs) {
+        super(`Could not acquire distributed lock for branch "${key}" within ${timeoutMs}ms — another instance may be creating the PR`);
+        this.name = "LockTimeoutError";
+    }
+}
+// ---------------------------------------------------------------------------
+// Adapters
+// ---------------------------------------------------------------------------
+/**
+ * No-op adapter used for SQLite (single-process deployments).
+ * The in-process pushQueue already serialises within a single process.
+ */
+export function createNoopLockAdapter() {
+    return {
+        async tryAcquire(_key) {
+            return true;
+        },
+        async release(_key) { },
+    };
+}
+/**
+ * PostgreSQL advisory lock adapter.
+ * Uses session-level `pg_try_advisory_lock` so the lock is automatically
+ * freed if the connection drops unexpectedly.
+ */
+export function createPgLockAdapter(db) {
+    return {
+        async tryAcquire(key) {
+            try {
+                const result = await db.execute(sql `SELECT pg_try_advisory_lock(hashtext(${key})) AS acquired`);
+                return result?.[0]?.acquired === true;
+            }
+            catch (err) {
+                log.warn({ err, key }, "pg_try_advisory_lock failed — treating as not acquired");
+                return false;
+            }
+        },
+        async release(key) {
+            try {
+                await db.execute(sql `SELECT pg_advisory_unlock(hashtext(${key}))`);
+            }
+            catch (err) {
+                // Best-effort; session-level locks are released when the connection
+                // closes anyway, so this is not critical.
+                log.warn({ err, key }, "pg_advisory_unlock failed (best-effort)");
+            }
+        },
+    };
+}
+/**
+ * Returns the appropriate lock adapter for the given database driver.
+ */
+export function createBranchLockAdapter(db) {
+    if (isPostgres(db)) {
+        return createPgLockAdapter(db);
+    }
+    return createNoopLockAdapter();
+}
+// ---------------------------------------------------------------------------
+// Core: withBranchLock
+// ---------------------------------------------------------------------------
+const POLL_INTERVAL_MS = 250;
+/**
+ * Acquire a distributed lock keyed by `key`, run `fn`, then release the lock.
+ *
+ * - If the lock is not available, the function polls every ~250 ms until
+ *   `timeoutMs` elapses, then throws `LockTimeoutError`.
+ * - The lock is always released in a `finally` block — including when `fn`
+ *   throws — so deadlocks cannot occur due to application errors.
+ *
+ * @param adapter   Lock backend (Postgres advisory lock or no-op for SQLite)
+ * @param key       Unique lock key (typically the git branch name)
+ * @param timeoutMs Maximum time to wait for the lock before failing
+ * @param fn        Work to perform while the lock is held
+ */
+export async function withBranchLock(adapter, key, timeoutMs, fn) {
+    const deadline = Date.now() + timeoutMs;
+    // Poll until we acquire the lock or the deadline passes.
+    while (true) {
+        const acquired = await adapter.tryAcquire(key);
+        if (acquired) {
+            log.debug({ key }, "distributed lock acquired");
+            try {
+                return await fn();
+            }
+            finally {
+                await adapter.release(key);
+                log.debug({ key }, "distributed lock released");
+            }
+        }
+        const remaining = deadline - Date.now();
+        if (remaining <= 0) {
+            throw new LockTimeoutError(key, timeoutMs);
+        }
+        log.debug({ key, remaining }, "distributed lock not available, retrying");
+        await new Promise((resolve) => setTimeout(resolve, Math.min(POLL_INTERVAL_MS, remaining)));
+    }
+}
+//# sourceMappingURL=distributed-lock.js.map

package/dist/pipeline/distributed-lock.js.map

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

package/dist/pipeline/error-classifier.d.ts

@@ -0,0 +1,9 @@
+/** Maximum number of automatic retries for transient failures. */
+export declare const MAX_TRANSIENT_RETRIES = 3;
+/**
+ * Returns true if the error message matches a known transient failure pattern
+ * (auth, network, rate limit). These failures are safe to retry with the
+ * existing worktree preserved.
+ */
+export declare function isTransientError(message: string): boolean;
+//# sourceMappingURL=error-classifier.d.ts.map

package/dist/pipeline/error-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-classifier.d.ts","sourceRoot":"","sources":["../../src/pipeline/error-classifier.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAiBvC;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEzD"}

package/dist/pipeline/error-classifier.js

@@ -0,0 +1,25 @@
+/** Maximum number of automatic retries for transient failures. */
+export const MAX_TRANSIENT_RETRIES = 3;
+const TRANSIENT_PATTERNS = [
+    /401/i,
+    /authentication/i,
+    /unauthorized/i,
+    /429/i,
+    /rate.?limit/i,
+    /ECONNRESET/,
+    /ETIMEDOUT/,
+    /ECONNREFUSED/,
+    /socket hang up/i,
+    /network.?timeout/i,
+    /fetch failed/i,
+    /unable to access/i,
+];
+/**
+ * Returns true if the error message matches a known transient failure pattern
+ * (auth, network, rate limit). These failures are safe to retry with the
+ * existing worktree preserved.
+ */
+export function isTransientError(message) {
+    return TRANSIENT_PATTERNS.some((p) => p.test(message));
+}
+//# sourceMappingURL=error-classifier.js.map

package/dist/pipeline/error-classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-classifier.js","sourceRoot":"","sources":["../../src/pipeline/error-classifier.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAEvC,MAAM,kBAAkB,GAAG;IACzB,MAAM;IACN,iBAAiB;IACjB,eAAe;IACf,MAAM;IACN,cAAc;IACd,YAAY;IACZ,WAAW;IACX,cAAc;IACd,iBAAiB;IACjB,mBAAmB;IACnB,eAAe;IACf,mBAAmB;CACpB,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AACzD,CAAC"}

package/dist/pipeline/index.d.ts

@@ -0,0 +1,9 @@
+export { defaultConfigs, validatePipelineConfigs, validateRepoConfigs } from "./config.js";
+export { resolvePipeline } from "./router.js";
+export { createQueue, type WorkQueue } from "./queue.js";
+export { PipelineRunner, type PipelineRunnerConfig, type LinearIssue } from "./runner.js";
+export { withBranchLock, createBranchLockAdapter, createPgLockAdapter, createNoopLockAdapter, LockTimeoutError, type LockAdapter, } from "./distributed-lock.js";
+export { isTransientError } from "./error-classifier.js";
+export { generatePRDescription, type PRDescriptionOptions } from "./pr-description.js";
+export { checkAutoMergeEligibility, attemptAutoMerge, type AutomergeOptions, type AutomergeCheckResult, type AutomergeResult, } from "./automerge.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pipeline/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC3F,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1F,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,WAAW,GACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACvF,OAAO,EACL,yBAAyB,EACzB,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,eAAe,GACrB,MAAM,gBAAgB,CAAC"}

package/dist/pipeline/index.js

@@ -0,0 +1,9 @@
+export { defaultConfigs, validatePipelineConfigs, validateRepoConfigs } from "./config.js";
+export { resolvePipeline } from "./router.js";
+export { createQueue } from "./queue.js";
+export { PipelineRunner } from "./runner.js";
+export { withBranchLock, createBranchLockAdapter, createPgLockAdapter, createNoopLockAdapter, LockTimeoutError, } from "./distributed-lock.js";
+export { isTransientError } from "./error-classifier.js";
+export { generatePRDescription } from "./pr-description.js";
+export { checkAutoMergeEligibility, attemptAutoMerge, } from "./automerge.js";
+//# sourceMappingURL=index.js.map

package/dist/pipeline/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pipeline/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC3F,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAkB,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,cAAc,EAA+C,MAAM,aAAa,CAAC;AAC1F,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,GAEjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAA6B,MAAM,qBAAqB,CAAC;AACvF,OAAO,EACL,yBAAyB,EACzB,gBAAgB,GAIjB,MAAM,gBAAgB,CAAC"}

package/dist/pipeline/pr-description.d.ts

@@ -0,0 +1,35 @@
+import type { HandoffArtifact } from "../types.js";
+/**
+ * Options for generating a PR description.
+ */
+export interface PRDescriptionOptions {
+    /** Handoff artifact from the final pipeline stage (may be undefined if pipeline failed early). */
+    handoff: HandoffArtifact | undefined;
+    /** Linear issue identifier (e.g. "BEC-109") appended as "Resolves <id>". */
+    issueId: string;
+    /** When true, adds a "Draft PR" callout with reasons. */
+    shouldDraft?: boolean;
+    /** RALPH satisfaction result — false means at least one acceptance criterion is unmet. */
+    ralphSatisfied?: boolean;
+    /** List of unmet RALPH gap items (used for count in draft reason). */
+    ralphGaps?: unknown[];
+    /** Blocking review findings that remain unresolved (used for count in draft reason). */
+    unresolvedBlockingFindings?: unknown[];
+    /** Agent-authored commit messages (not auto-committed fallbacks) to include in a Commits section. */
+    agentCommits?: string[];
+}
+/**
+ * Build the markdown body for an auto-generated pull request.
+ *
+ * Template order:
+ *   ## Summary    — from handoff.summary (fallback: "No summary available.")
+ *   ## Changes    — bulleted list of handoff.filesChanged (fallback: "No file changes recorded.")
+ *   ## Test plan  — filtered list of test/spec files from filesChanged (fallback: "No test changes")
+ *   ## Commits    — agent-authored commit messages (section omitted when empty)
+ *   > Draft PR    — draft-status callout (section omitted when not a draft)
+ *   Resolves <id> — Linear issue link
+ *
+ * Sections are separated by double newlines (markdown paragraph breaks).
+ */
+export declare function generatePRDescription(options: PRDescriptionOptions): string;
+//# sourceMappingURL=pr-description.d.ts.map

package/dist/pipeline/pr-description.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-description.d.ts","sourceRoot":"","sources":["../../src/pipeline/pr-description.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,kGAAkG;IAClG,OAAO,EAAE,eAAe,GAAG,SAAS,CAAC;IACrC,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,0FAA0F;IAC1F,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,sEAAsE;IACtE,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;IACtB,wFAAwF;IACxF,0BAA0B,CAAC,EAAE,OAAO,EAAE,CAAC;IACvC,qGAAqG;IACrG,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAqD3E"}

package/dist/pipeline/pr-description.js

@@ -0,0 +1,52 @@
+/**
+ * Build the markdown body for an auto-generated pull request.
+ *
+ * Template order:
+ *   ## Summary    — from handoff.summary (fallback: "No summary available.")
+ *   ## Changes    — bulleted list of handoff.filesChanged (fallback: "No file changes recorded.")
+ *   ## Test plan  — filtered list of test/spec files from filesChanged (fallback: "No test changes")
+ *   ## Commits    — agent-authored commit messages (section omitted when empty)
+ *   > Draft PR    — draft-status callout (section omitted when not a draft)
+ *   Resolves <id> — Linear issue link
+ *
+ * Sections are separated by double newlines (markdown paragraph breaks).
+ */
+export function generatePRDescription(options) {
+    const { handoff, issueId, shouldDraft = false, ralphSatisfied = true, ralphGaps = [], unresolvedBlockingFindings = [], agentCommits = [], } = options;
+    const parts = [];
+    // Summary section
+    parts.push(`## Summary\n${handoff?.summary ?? "No summary available."}`);
+    // Changes section
+    if (handoff?.filesChanged?.length) {
+        parts.push(`## Changes\n${handoff.filesChanged.map((f) => `- \`${f}\``).join("\n")}`);
+    }
+    else {
+        parts.push(`## Changes\nNo file changes recorded.`);
+    }
+    // Test plan section — filter filesChanged for test/spec files
+    const testFiles = handoff?.filesChanged?.filter((f) => /[/._]tests?[/._]|[/._]specs?[/._]|__tests__|\.test\.[jt]sx?$|\.spec\.[jt]sx?$/i.test(f)) ?? [];
+    if (testFiles.length > 0) {
+        parts.push(`## Test plan\n${testFiles.map((f) => `- \`${f}\``).join("\n")}`);
+    }
+    else {
+        parts.push(`## Test plan\nNo test changes`);
+    }
+    // Commits section — include agent-authored commit messages (not auto-committed fallbacks)
+    const agentOnlyCommits = agentCommits.filter((msg) => !msg.includes("(auto-committed)"));
+    if (agentOnlyCommits.length > 0) {
+        parts.push(`## Commits\n${agentOnlyCommits.map((c) => `- ${c}`).join("\n")}`);
+    }
+    // Flag draft status with reason
+    if (shouldDraft) {
+        const reasons = [];
+        if (!ralphSatisfied)
+            reasons.push(`RALPH found ${ralphGaps.length} unmet acceptance criteria`);
+        if (unresolvedBlockingFindings.length > 0)
+            reasons.push(`${unresolvedBlockingFindings.length} blocking review findings remain`);
+        parts.push(`> **Draft PR** — ${reasons.join("; ")}. See PR comments for details.`);
+    }
+    // Issue link at the end of the description
+    parts.push(`Resolves ${issueId}`);
+    return parts.join("\n\n");
+}
+//# sourceMappingURL=pr-description.js.map

package/dist/pipeline/pr-description.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-description.js","sourceRoot":"","sources":["../../src/pipeline/pr-description.ts"],"names":[],"mappings":"AAsBA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAA6B;IACjE,MAAM,EACJ,OAAO,EACP,OAAO,EACP,WAAW,GAAG,KAAK,EACnB,cAAc,GAAG,IAAI,EACrB,SAAS,GAAG,EAAE,EACd,0BAA0B,GAAG,EAAE,EAC/B,YAAY,GAAG,EAAE,GAClB,GAAG,OAAO,CAAC;IAEZ,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,kBAAkB;IAClB,KAAK,CAAC,IAAI,CAAC,eAAe,OAAO,EAAE,OAAO,IAAI,uBAAuB,EAAE,CAAC,CAAC;IAEzE,kBAAkB;IAClB,IAAI,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,eAAe,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACxF,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IACtD,CAAC;IAED,8DAA8D;IAC9D,MAAM,SAAS,GACb,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAClC,gFAAgF,CAAC,IAAI,CAAC,CAAC,CAAC,CACzF,IAAI,EAAE,CAAC;IACV,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,iBAAiB,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/E,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAC9C,CAAC;IAED,0FAA0F;IAC1F,MAAM,gBAAgB,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC;IACzF,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,eAAe,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,gCAAgC;IAChC,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,IAAI,CAAC,cAAc;YAAE,OAAO,CAAC,IAAI,CAAC,eAAe,SAAS,CAAC,MAAM,4BAA4B,CAAC,CAAC;QAC/F,IAAI,0BAA0B,CAAC,MAAM,GAAG,CAAC;YACvC,OAAO,CAAC,IAAI,CAAC,GAAG,0BAA0B,CAAC,MAAM,kCAAkC,CAAC,CAAC;QACvF,KAAK,CAAC,IAAI,CAAC,oBAAoB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;IACrF,CAAC;IAED,2CAA2C;IAC3C,KAAK,CAAC,IAAI,CAAC,YAAY,OAAO,EAAE,CAAC,CAAC;IAElC,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC"}

package/dist/pipeline/queue.d.ts

@@ -0,0 +1,7 @@
+export interface WorkQueue {
+    enqueue<T>(fn: () => Promise<T>): Promise<T>;
+    readonly pending: number;
+    readonly running: number;
+}
+export declare function createQueue(concurrency: number): WorkQueue;
+//# sourceMappingURL=queue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/pipeline/queue.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAsC1D"}

package/dist/pipeline/queue.js

@@ -0,0 +1,39 @@
+export function createQueue(concurrency) {
+    let running = 0;
+    let pending = 0;
+    const waiting = [];
+    async function acquire() {
+        if (running < concurrency) {
+            running++;
+            return;
+        }
+        pending++;
+        await new Promise((resolve) => waiting.push(resolve));
+        pending--;
+        running++;
+    }
+    function release() {
+        running--;
+        const next = waiting.shift();
+        if (next)
+            next();
+    }
+    return {
+        async enqueue(fn) {
+            await acquire();
+            try {
+                return await fn();
+            }
+            finally {
+                release();
+            }
+        },
+        get pending() {
+            return pending;
+        },
+        get running() {
+            return running;
+        },
+    };
+}
+//# sourceMappingURL=queue.js.map

package/dist/pipeline/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../src/pipeline/queue.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,WAAW,CAAC,WAAmB;IAC7C,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,MAAM,OAAO,GAAsB,EAAE,CAAC;IAEtC,KAAK,UAAU,OAAO;QACpB,IAAI,OAAO,GAAG,WAAW,EAAE,CAAC;YAC1B,OAAO,EAAE,CAAC;YACV,OAAO;QACT,CAAC;QACD,OAAO,EAAE,CAAC;QACV,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QAC5D,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,SAAS,OAAO;QACd,OAAO,EAAE,CAAC;QACV,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;QAC7B,IAAI,IAAI;YAAE,IAAI,EAAE,CAAC;IACnB,CAAC;IAED,OAAO;QACL,KAAK,CAAC,OAAO,CAAI,EAAoB;YACnC,MAAM,OAAO,EAAE,CAAC;YAChB,IAAI,CAAC;gBACH,OAAO,MAAM,EAAE,EAAE,CAAC;YACpB,CAAC;oBAAS,CAAC;gBACT,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;QACD,IAAI,OAAO;YACT,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,IAAI,OAAO;YACT,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/pipeline/router.d.ts

@@ -0,0 +1,6 @@
+import type { PipelineConfig } from "../types.js";
+export declare function resolvePipeline(labels: string[], configs: Record<string, PipelineConfig>): {
+    key: string;
+    config: PipelineConfig;
+} | null;
+//# sourceMappingURL=router.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/pipeline/router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAKlD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GACtC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,GAAG,IAAI,CAehD"}

package/dist/pipeline/router.js

@@ -0,0 +1,19 @@
+// Priority order: quick-fix > bug > auto-implement > needs-design
+const LABEL_PRIORITY = ["quick-fix", "bug", "auto-implement", "needs-design"];
+export function resolvePipeline(labels, configs) {
+    const lower = labels.map((l) => l.toLowerCase());
+    // Check labels in priority order
+    for (const label of LABEL_PRIORITY) {
+        if (lower.includes(label) && configs[label]) {
+            return { key: label, config: configs[label] };
+        }
+    }
+    // Fall back to first matching label
+    for (const lbl of lower) {
+        if (configs[lbl]) {
+            return { key: lbl, config: configs[lbl] };
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=router.js.map

package/dist/pipeline/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/pipeline/router.ts"],"names":[],"mappings":"AAEA,kEAAkE;AAClE,MAAM,cAAc,GAAG,CAAC,WAAW,EAAE,KAAK,EAAE,gBAAgB,EAAE,cAAc,CAAC,CAAC;AAE9E,MAAM,UAAU,eAAe,CAC7B,MAAgB,EAChB,OAAuC;IAEvC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IACjD,iCAAiC;IACjC,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;QACnC,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5C,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChD,CAAC;IACH,CAAC;IACD,oCAAoC;IACpC,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACjB,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5C,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}