@proletariat/cli 0.3.94 → 0.3.96

package/dist/lib/sync/daemon-process.js

@@ -0,0 +1,184 @@
+/**
+ * Daemon Process
+ *
+ * This is the background process spawned by `prlt sync start`.
+ * It runs a sync cycle and merge queue cycle on a configurable interval.
+ *
+ * Args: [hqPath, intervalSeconds]
+ */
+import * as fs from 'node:fs';
+import { openWorkspaceDatabase } from '../database/index.js';
+import { getPMOContext } from '../pmo/pmo-context.js';
+import { runSyncCycle } from './engine.js';
+import { runMergeQueueCycle } from './merge-queue.js';
+import { removeDaemonPid, getDaemonLogPath } from './daemon.js';
+import { GCScheduler, collectGCCandidates, executeGC, } from '../gc/index.js';
+const args = process.argv.slice(2);
+const hqPath = args[0];
+const intervalSeconds = parseInt(args[1] || '60', 10);
+if (!hqPath) {
+    console.error('Usage: daemon-process <hqPath> [intervalSeconds]');
+    process.exit(1);
+}
+const logPath = getDaemonLogPath(hqPath);
+function log(msg) {
+    const timestamp = new Date().toISOString();
+    const line = `[${timestamp}] ${msg}\n`;
+    fs.appendFileSync(logPath, line);
+}
+async function getProjectId() {
+    const context = await getPMOContext();
+    const projects = await context.storage.listProjects();
+    await context.storage.close();
+    if (projects.length === 0) {
+        throw new Error('No projects found');
+    }
+    return projects[0].id;
+}
+// GC scheduler with 1-hour grace period — persists across daemon cycles
+const gcScheduler = new GCScheduler(60 * 60 * 1000);
+/** Map ticket priority strings to numeric values (lower = higher priority). */
+function priorityToNumber(priority) {
+    switch (priority) {
+        case 'P0': return 0;
+        case 'P1': return 1;
+        case 'P2': return 2;
+        case 'P3': return 3;
+        default: return 3;
+    }
+}
+async function cycle() {
+    let db;
+    try {
+        db = openWorkspaceDatabase(hqPath);
+        const context = await getPMOContext();
+        const projectId = await getProjectId();
+        const storage = context.storage;
+        // Phase 1: Reconciliation — sync ticket state with PR state
+        const report = await runSyncCycle(db, storage, projectId, {
+            cwd: hqPath,
+            log,
+        });
+        if (report.applied.length > 0) {
+            log(`Applied ${report.applied.length} correction(s)`);
+        }
+        if (report.failed.length > 0) {
+            log(`Failed ${report.failed.length} correction(s)`);
+        }
+        // Phase 2: Merge Queue — sequential rebase-test-merge pipeline
+        try {
+            // Build priority map from tickets for queue ordering
+            const branchPriorities = new Map();
+            const startedTickets = await storage.listTickets(projectId, { statusCategory: 'started' });
+            for (const ticket of startedTickets) {
+                if (ticket.branch) {
+                    branchPriorities.set(ticket.branch, priorityToNumber(ticket.priority));
+                }
+            }
+            const mqResult = runMergeQueueCycle({
+                hqPath,
+                cwd: hqPath,
+                log,
+                branchPriorities,
+            });
+            if (mqResult.action !== 'none' && mqResult.action !== 'paused') {
+                log(`Merge queue: ${mqResult.action}${mqResult.prNumber ? ` PR #${mqResult.prNumber}` : ''}${mqResult.reason ? ` — ${mqResult.reason}` : ''}`);
+            }
+        }
+        catch (mqErr) {
+            const mqMsg = mqErr instanceof Error ? mqErr.message : String(mqErr);
+            log(`Merge queue error: ${mqMsg}`);
+        }
+        // Phase 3: Garbage Collection — schedule cleanup for merged PRs, run ready cleanups
+        try {
+            // Schedule GC for any tickets that just moved to Done (PR merged)
+            const mergedActions = report.applied.filter(a => a.type === 'move_to_done');
+            if (mergedActions.length > 0) {
+                const completedTickets = await storage.listTickets(projectId, { statusCategory: 'completed' });
+                for (const action of mergedActions) {
+                    const ticket = completedTickets.find(t => t.id === action.ticketId);
+                    if (ticket?.branch) {
+                        gcScheduler.schedule(ticket.branch);
+                        log(`GC: Scheduled cleanup for branch ${ticket.branch} (1hr grace period)`);
+                    }
+                }
+            }
+            // Process any ready cleanups (grace period expired)
+            const readyBranches = gcScheduler.getReady();
+            if (readyBranches.length > 0) {
+                log(`GC: Processing ${readyBranches.length} cleanup(s) past grace period`);
+                const candidates = collectGCCandidates({
+                    hqPath,
+                    staleDays: 7,
+                    log,
+                });
+                // Only clean up the branches that are ready
+                const readySet = new Set(readyBranches);
+                const readyCandidates = candidates.filter(c => readySet.has(c.branch));
+                if (readyCandidates.length > 0) {
+                    const result = executeGC(readyCandidates, {
+                        hqPath,
+                        execute: true,
+                        log,
+                    });
+                    if (result.worktreesRemoved.length > 0) {
+                        log(`GC: Removed ${result.worktreesRemoved.length} worktree(s), ${result.containersRemoved.length} container(s), ${result.branchesPruned.length} branch(es)`);
+                    }
+                    if (result.errors.length > 0) {
+                        log(`GC: ${result.errors.length} error(s): ${result.errors.join('; ')}`);
+                    }
+                }
+                // Mark as completed regardless of whether cleanup was needed
+                for (const branch of readyBranches) {
+                    gcScheduler.complete(branch);
+                }
+            }
+        }
+        catch (gcErr) {
+            const gcMsg = gcErr instanceof Error ? gcErr.message : String(gcErr);
+            log(`GC error: ${gcMsg}`);
+        }
+        await context.storage.close();
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        log(`Error: ${msg}`);
+    }
+    finally {
+        if (db) {
+            try {
+                db.close();
+            }
+            catch { }
+        }
+    }
+}
+// Signal handling
+process.on('SIGTERM', () => {
+    log('Received SIGTERM — shutting down');
+    removeDaemonPid(hqPath);
+    process.exit(0);
+});
+process.on('SIGINT', () => {
+    log('Received SIGINT — shutting down');
+    removeDaemonPid(hqPath);
+    process.exit(0);
+});
+// Main loop
+log(`Daemon started (PID ${process.pid}, interval ${intervalSeconds}s)`);
+async function run() {
+    // Run initial cycle immediately
+    await cycle();
+    // Then schedule periodic runs
+    setInterval(() => {
+        cycle().catch(err => {
+            log(`Unhandled error in cycle: ${err}`);
+        });
+    }, intervalSeconds * 1000);
+}
+run().catch(err => {
+    log(`Fatal: ${err}`);
+    removeDaemonPid(hqPath);
+    process.exit(1);
+});
+//# sourceMappingURL=daemon-process.js.map

package/dist/lib/sync/daemon-process.js.map

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

package/dist/lib/sync/daemon.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Sync Daemon
+ *
+ * Manages a background process that periodically runs the sync engine.
+ * Uses a PID file in the HQ directory to track the daemon process.
+ */
+export interface DaemonInfo {
+    pid: number;
+    startedAt: string;
+    intervalSeconds: number;
+}
+/**
+ * Get the path to the daemon PID file.
+ */
+export declare function getDaemonPidPath(hqPath: string): string;
+/**
+ * Get the path to the daemon log file.
+ */
+export declare function getDaemonLogPath(hqPath: string): string;
+/**
+ * Read daemon info from PID file.
+ */
+export declare function getDaemonInfo(hqPath: string): DaemonInfo | null;
+/**
+ * Write daemon info to PID file.
+ */
+export declare function writeDaemonInfo(hqPath: string, info: DaemonInfo): void;
+/**
+ * Remove daemon PID file.
+ */
+export declare function removeDaemonPid(hqPath: string): void;
+/**
+ * Check if a daemon process is alive by PID.
+ */
+export declare function isDaemonRunning(hqPath: string): boolean;
+/**
+ * Stop the daemon process.
+ */
+export declare function stopDaemon(hqPath: string): boolean;

package/dist/lib/sync/daemon.js

@@ -0,0 +1,91 @@
+/**
+ * Sync Daemon
+ *
+ * Manages a background process that periodically runs the sync engine.
+ * Uses a PID file in the HQ directory to track the daemon process.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+const DAEMON_PID_FILE = 'sync-daemon.pid';
+const DAEMON_LOG_FILE = 'sync-daemon.log';
+/**
+ * Get the path to the daemon PID file.
+ */
+export function getDaemonPidPath(hqPath) {
+    return path.join(hqPath, '.proletariat', DAEMON_PID_FILE);
+}
+/**
+ * Get the path to the daemon log file.
+ */
+export function getDaemonLogPath(hqPath) {
+    return path.join(hqPath, '.proletariat', DAEMON_LOG_FILE);
+}
+/**
+ * Read daemon info from PID file.
+ */
+export function getDaemonInfo(hqPath) {
+    const pidPath = getDaemonPidPath(hqPath);
+    try {
+        const content = fs.readFileSync(pidPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write daemon info to PID file.
+ */
+export function writeDaemonInfo(hqPath, info) {
+    const pidPath = getDaemonPidPath(hqPath);
+    fs.writeFileSync(pidPath, JSON.stringify(info, null, 2));
+}
+/**
+ * Remove daemon PID file.
+ */
+export function removeDaemonPid(hqPath) {
+    const pidPath = getDaemonPidPath(hqPath);
+    try {
+        fs.unlinkSync(pidPath);
+    }
+    catch {
+        // File may not exist
+    }
+}
+/**
+ * Check if a daemon process is alive by PID.
+ */
+export function isDaemonRunning(hqPath) {
+    const info = getDaemonInfo(hqPath);
+    if (!info)
+        return false;
+    try {
+        // Sending signal 0 checks if process exists without killing it
+        process.kill(info.pid, 0);
+        return true;
+    }
+    catch {
+        // Process doesn't exist — clean up stale PID file
+        removeDaemonPid(hqPath);
+        return false;
+    }
+}
+/**
+ * Stop the daemon process.
+ */
+export function stopDaemon(hqPath) {
+    const info = getDaemonInfo(hqPath);
+    if (!info)
+        return false;
+    try {
+        process.kill(info.pid, 'SIGTERM');
+        removeDaemonPid(hqPath);
+        return true;
+    }
+    catch {
+        // Process may already be dead
+        removeDaemonPid(hqPath);
+        return false;
+    }
+}
+//# sourceMappingURL=daemon.js.map

package/dist/lib/sync/daemon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.js","sourceRoot":"","sources":["../../../src/lib/sync/daemon.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAC7B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAEjC,MAAM,eAAe,GAAG,iBAAiB,CAAA;AACzC,MAAM,eAAe,GAAG,iBAAiB,CAAA;AAQzC;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,eAAe,CAAC,CAAA;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,eAAe,CAAC,CAAA;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAA;IACxC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QACjD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAe,CAAA;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,IAAgB;IAC9D,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAA;IACxC,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;AAC1D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAA;IACxC,IAAI,CAAC;QACH,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,qBAAqB;IACvB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;IAClC,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAA;IAEvB,IAAI,CAAC;QACH,+DAA+D;QAC/D,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;QACzB,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,kDAAkD;QAClD,eAAe,CAAC,MAAM,CAAC,CAAA;QACvB,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;IAClC,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAA;IAEvB,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAA;QACjC,eAAe,CAAC,MAAM,CAAC,CAAA;QACvB,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,8BAA8B;QAC9B,eAAe,CAAC,MAAM,CAAC,CAAA;QACvB,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC"}

package/dist/lib/sync/engine.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Sync Engine
+ *
+ * Orchestrates the reconciliation process: gathers ticket state and PR state,
+ * runs the reconciler, and applies corrective actions through providers.
+ *
+ * This is the "run once" engine. The daemon wraps this with a polling loop.
+ */
+import type Database from 'better-sqlite3';
+import type { ProviderStorage } from '../providers/types.js';
+import type { PMOStorage } from '../pmo/types.js';
+import { type ReconcileAction, type ReconcileResult } from './reconciler.js';
+export interface SyncEngineOptions {
+    /** Working directory for git/gh operations */
+    cwd?: string;
+    /** Callback for logging */
+    log?: (msg: string) => void;
+    /** If true, don't actually move tickets — just report what would happen */
+    dryRun?: boolean;
+}
+export interface SyncReport {
+    result: ReconcileResult;
+    applied: ReconcileAction[];
+    skipped: ReconcileAction[];
+    failed: Array<{
+        action: ReconcileAction;
+        error: string;
+    }>;
+}
+/**
+ * Run a single reconciliation cycle.
+ *
+ * 1. List all tickets in started/review states
+ * 2. For each, check PR status
+ * 3. Run reconciler to determine actions
+ * 4. Apply actions through providers
+ */
+export declare function runSyncCycle(db: Database.Database, storage: PMOStorage & ProviderStorage, projectId: string, options?: SyncEngineOptions): Promise<SyncReport>;

package/dist/lib/sync/engine.js

@@ -0,0 +1,145 @@
+/**
+ * Sync Engine
+ *
+ * Orchestrates the reconciliation process: gathers ticket state and PR state,
+ * runs the reconciler, and applies corrective actions through providers.
+ *
+ * This is the "run once" engine. The daemon wraps this with a polling loop.
+ */
+import { resolveTicketProvider } from '../providers/resolver.js';
+import { ExecutionStorage } from '../execution/storage.js';
+import { getPRForBranch, getPRChecks, listOpenPRs, } from '../pr/index.js';
+import { reconcileTicket, } from './reconciler.js';
+// =============================================================================
+// Engine
+// =============================================================================
+/**
+ * Run a single reconciliation cycle.
+ *
+ * 1. List all tickets in started/review states
+ * 2. For each, check PR status
+ * 3. Run reconciler to determine actions
+ * 4. Apply actions through providers
+ */
+export async function runSyncCycle(db, storage, projectId, options = {}) {
+    const { cwd, log, dryRun } = options;
+    const execStorage = new ExecutionStorage(db);
+    // Gather all tickets in active states (started = In Progress / In Review)
+    const startedTickets = await storage.listTickets(projectId, { statusCategory: 'started' });
+    // Also check recently completed tickets to catch any that were manually moved
+    // but whose PR state doesn't match
+    log?.(`Checking ${startedTickets.length} active ticket(s)...`);
+    // Pre-fetch open PRs to reduce API calls
+    const openPRs = listOpenPRs(cwd);
+    const prByBranch = new Map();
+    for (const pr of openPRs) {
+        prByBranch.set(pr.headBranch, pr);
+    }
+    const actions = [];
+    const errors = [];
+    for (const ticket of startedTickets) {
+        try {
+            const ctx = buildContext(ticket, prByBranch, execStorage, cwd);
+            const action = reconcileTicket(ctx);
+            if (action) {
+                actions.push(action);
+            }
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            errors.push({ ticketId: ticket.id, error: msg });
+        }
+    }
+    const result = {
+        actions,
+        checked: startedTickets.length,
+        errors,
+    };
+    // Apply actions
+    const applied = [];
+    const skipped = [];
+    const failed = [];
+    for (const action of actions) {
+        if (dryRun) {
+            skipped.push(action);
+            log?.(`[dry-run] Would ${formatAction(action)}`);
+            continue;
+        }
+        if (action.type === 'flag_stale') {
+            // Stale tickets are logged but not moved
+            log?.(`Stale: ${action.ticketId} — ${action.reason}`);
+            applied.push(action);
+            continue;
+        }
+        try {
+            const ticket = await storage.getTicket(action.ticketId);
+            if (!ticket) {
+                failed.push({ action, error: 'Ticket not found' });
+                continue;
+            }
+            const provider = resolveTicketProvider(action.ticketId, ticket.projectId ?? projectId, db, storage, ticket.metadata);
+            if (action.targetStatus) {
+                const moveResult = await provider.moveTicket(action.ticketId, action.targetStatus);
+                if (moveResult.success) {
+                    log?.(`Synced: ${action.ticketId} → ${action.targetStatus} (${action.reason})`);
+                    applied.push(action);
+                    // If moving to Done, also mark any running executions as completed
+                    if (action.type === 'move_to_done') {
+                        markExecutionsCompleted(execStorage, action.ticketId);
+                    }
+                }
+                else {
+                    failed.push({ action, error: moveResult.error ?? 'Move failed' });
+                    log?.(`Failed: ${action.ticketId} — ${moveResult.error}`);
+                }
+            }
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            failed.push({ action, error: msg });
+            log?.(`Error: ${action.ticketId} — ${msg}`);
+        }
+    }
+    return { result, applied, skipped, failed };
+}
+// =============================================================================
+// Helpers
+// =============================================================================
+function buildContext(ticket, prByBranch, execStorage, cwd) {
+    // Look up PR by branch — try ticket.branch first, then external key patterns
+    let pr = null;
+    let checks = [];
+    if (ticket.branch) {
+        // First check the pre-fetched open PRs
+        pr = prByBranch.get(ticket.branch) ?? null;
+        // If not found in open PRs, the PR might be merged/closed — fetch directly
+        if (!pr) {
+            pr = getPRForBranch(ticket.branch, cwd);
+        }
+    }
+    if (pr && pr.state === 'OPEN') {
+        checks = getPRChecks(pr.number, cwd);
+    }
+    // Check for active execution
+    const hasActiveExecution = !!execStorage.getRunningExecution(ticket.id);
+    return { ticket, pr, checks, hasActiveExecution };
+}
+function markExecutionsCompleted(execStorage, ticketId) {
+    const running = execStorage.getRunningExecution(ticketId);
+    if (running) {
+        execStorage.updateStatus(running.id, 'completed');
+    }
+}
+function formatAction(action) {
+    switch (action.type) {
+        case 'move_to_done':
+            return `move ${action.ticketId} to Done (${action.reason})`;
+        case 'move_to_review':
+            return `move ${action.ticketId} to Review (${action.reason})`;
+        case 'move_to_backlog':
+            return `move ${action.ticketId} to Backlog (${action.reason})`;
+        case 'flag_stale':
+            return `flag ${action.ticketId} as stale (${action.reason})`;
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/lib/sync/engine.js.map

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

package/dist/lib/sync/merge-queue.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Merge Queue
+ *
+ * Sequential rebase-test-merge pipeline for parallel agent PRs.
+ *
+ * With strict branch protection (PR must be up-to-date with main), parallel
+ * agent PRs create a rebase treadmill. The merge queue processes green PRs
+ * one at a time: rebase on main → wait for CI → merge if green → eject if red.
+ *
+ * State machine per cycle:
+ * 1. If paused → skip
+ * 2. If a PR is currently being processed (rebased, waiting for CI):
+ *    - CI green → merge, rebase siblings
+ *    - CI failed → eject (label + comment)
+ *    - CI pending → wait
+ * 3. If no current PR:
+ *    - Build queue: open, non-draft PRs with green CI, ordered by priority then age
+ *    - Pick first → rebase → set as current
+ *    - If rebase fails (conflicts) → eject, try next
+ */
+import type { PRInfo } from '../pr/index.js';
+import { listOpenPRs, getPRChecks, getPRByNumber, mergePR } from '../pr/index.js';
+import { rebaseSiblingPRs } from '../shipping/rebase.js';
+export interface MergeQueueState {
+    /** Whether the merge queue is paused */
+    paused: boolean;
+    /** ISO timestamp when paused */
+    pausedAt: string | null;
+    /** PR currently being processed (rebased, waiting for CI) */
+    currentPR: CurrentPRState | null;
+    /** Last PR that was successfully merged */
+    lastMergedPR: MergedPRInfo | null;
+    /** ISO timestamp of last cycle */
+    lastCycleAt: string | null;
+    /** Recently ejected PRs (max 10) */
+    ejectedPRs: EjectedPRInfo[];
+}
+export interface CurrentPRState {
+    prNumber: number;
+    headBranch: string;
+    baseBranch: string;
+    ticketId: string | null;
+    priority: number;
+    rebasedAt: string;
+}
+export interface MergedPRInfo {
+    prNumber: number;
+    headBranch: string;
+    mergedAt: string;
+}
+export interface EjectedPRInfo {
+    prNumber: number;
+    headBranch: string;
+    reason: string;
+    ejectedAt: string;
+}
+export interface MergeQueueEntry {
+    pr: PRInfo;
+    ticketId: string | null;
+    priority: number;
+}
+export interface MergeQueueCycleResult {
+    action: 'none' | 'rebase_started' | 'waiting_ci' | 'merged' | 'ejected' | 'paused' | 'error';
+    prNumber?: number;
+    reason?: string;
+    queueSize: number;
+}
+export interface MergeQueueOptions {
+    /** HQ path for state file */
+    hqPath: string;
+    /** Working directory for git/gh operations */
+    cwd?: string;
+    /** Logging callback */
+    log?: (msg: string) => void;
+    /** Merge method (default: squash) */
+    mergeMethod?: 'merge' | 'squash' | 'rebase';
+    /** Delete branch after merging (default: true) */
+    deleteBranch?: boolean;
+    /** Map of PR head branch to priority (0=P0, 1=P1, 2=P2, 3=P3). Lower = higher priority */
+    branchPriorities?: Map<string, number>;
+}
+/** Injectable dependencies for testing */
+export interface MergeQueueDeps {
+    listOpenPRs: typeof listOpenPRs;
+    getPRChecks: typeof getPRChecks;
+    getPRByNumber: typeof getPRByNumber;
+    mergePR: typeof mergePR;
+    rebaseSiblingPRs: typeof rebaseSiblingPRs;
+    updatePRBranch: (prNumber: number, cwd?: string) => import('../shipping/types.js').UpdateBranchResult;
+    addLabel: (prNumber: number, label: string, cwd?: string) => boolean;
+    addComment: (prNumber: number, body: string, cwd?: string) => boolean;
+}
+export declare function getMergeQueueStatePath(hqPath: string): string;
+export declare function getDefaultState(): MergeQueueState;
+export declare function getMergeQueueState(hqPath: string): MergeQueueState;
+export declare function saveMergeQueueState(hqPath: string, state: MergeQueueState): void;
+export declare function isMergeQueuePaused(hqPath: string): boolean;
+export declare function pauseMergeQueue(hqPath: string): MergeQueueState;
+export declare function resumeMergeQueue(hqPath: string): MergeQueueState;
+/**
+ * Build the merge queue: open, non-draft PRs with all CI checks green,
+ * ordered by priority (P0 first) then by creation date (oldest first).
+ */
+export declare function buildMergeQueue(options: {
+    cwd?: string;
+    branchPriorities?: Map<string, number>;
+}, deps?: Pick<MergeQueueDeps, 'listOpenPRs' | 'getPRChecks'>): MergeQueueEntry[];
+/**
+ * Run a single merge queue cycle.
+ *
+ * Called by the daemon on each interval. Handles the state machine:
+ * - If paused, returns immediately
+ * - If a PR is in progress (rebased, waiting CI), checks status
+ * - If no PR in progress, picks next from queue and rebases
+ */
+export declare function runMergeQueueCycle(options: MergeQueueOptions, deps?: MergeQueueDeps): MergeQueueCycleResult;