@proletariat/cli 0.3.95 → 0.3.97

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;

package/dist/lib/sync/merge-queue.js

@@ -0,0 +1,321 @@
+/**
+ * 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 * as fs from 'node:fs';
+import * as path from 'node:path';
+import { listOpenPRs, getPRChecks, getPRByNumber, mergePR, } from '../pr/index.js';
+import { rebaseSiblingPRs } from '../shipping/rebase.js';
+import { GitHubProvider } from '../shipping/github.js';
+// =============================================================================
+// Constants
+// =============================================================================
+const MERGE_QUEUE_STATE_FILE = 'merge-queue.json';
+const MAX_EJECTED_HISTORY = 10;
+const EJECTED_LABEL = 'merge-queue-ejected';
+const EJECTED_COMMENT_PREFIX = 'Merge queue ejected this PR:';
+const DEFAULT_PRIORITY = 3; // P3 — lowest
+// =============================================================================
+// State Management
+// =============================================================================
+export function getMergeQueueStatePath(hqPath) {
+    return path.join(hqPath, '.proletariat', MERGE_QUEUE_STATE_FILE);
+}
+export function getDefaultState() {
+    return {
+        paused: false,
+        pausedAt: null,
+        currentPR: null,
+        lastMergedPR: null,
+        lastCycleAt: null,
+        ejectedPRs: [],
+    };
+}
+export function getMergeQueueState(hqPath) {
+    const statePath = getMergeQueueStatePath(hqPath);
+    try {
+        const content = fs.readFileSync(statePath, 'utf-8');
+        return { ...getDefaultState(), ...JSON.parse(content) };
+    }
+    catch {
+        return getDefaultState();
+    }
+}
+export function saveMergeQueueState(hqPath, state) {
+    const statePath = getMergeQueueStatePath(hqPath);
+    fs.writeFileSync(statePath, JSON.stringify(state, null, 2));
+}
+// =============================================================================
+// Pause / Resume
+// =============================================================================
+export function isMergeQueuePaused(hqPath) {
+    return getMergeQueueState(hqPath).paused;
+}
+export function pauseMergeQueue(hqPath) {
+    const state = getMergeQueueState(hqPath);
+    state.paused = true;
+    state.pausedAt = new Date().toISOString();
+    saveMergeQueueState(hqPath, state);
+    return state;
+}
+export function resumeMergeQueue(hqPath) {
+    const state = getMergeQueueState(hqPath);
+    state.paused = false;
+    state.pausedAt = null;
+    saveMergeQueueState(hqPath, state);
+    return state;
+}
+// =============================================================================
+// Queue Building
+// =============================================================================
+/**
+ * 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 function buildMergeQueue(options, deps = { listOpenPRs, getPRChecks }) {
+    const { cwd, branchPriorities } = options;
+    const openPRs = deps.listOpenPRs(cwd);
+    const entries = [];
+    for (const pr of openPRs) {
+        // Skip drafts
+        if (pr.isDraft)
+            continue;
+        // Check CI
+        const checks = deps.getPRChecks(pr.number, cwd);
+        if (checks.length === 0)
+            continue; // No checks = not ready
+        if (!allChecksGreen(checks))
+            continue;
+        // Resolve priority from branch
+        const priority = branchPriorities?.get(pr.headBranch) ?? DEFAULT_PRIORITY;
+        const ticketId = extractTicketIdFromBranch(pr.headBranch);
+        entries.push({ pr, ticketId, priority });
+    }
+    // Sort: lower priority number first (P0 < P1 < P2 < P3), then oldest first
+    entries.sort((a, b) => {
+        if (a.priority !== b.priority)
+            return a.priority - b.priority;
+        return new Date(a.pr.createdAt).getTime() - new Date(b.pr.createdAt).getTime();
+    });
+    return entries;
+}
+// =============================================================================
+// Main Cycle
+// =============================================================================
+const _defaultProvider = new GitHubProvider();
+const defaultDeps = {
+    listOpenPRs,
+    getPRChecks,
+    getPRByNumber,
+    mergePR,
+    rebaseSiblingPRs,
+    updatePRBranch: (prNumber, cwd) => _defaultProvider.updatePRBranch(prNumber, cwd),
+    addLabel: (prNumber, label, cwd) => _defaultProvider.addLabel(prNumber, label, cwd),
+    addComment: (prNumber, body, cwd) => _defaultProvider.addComment(prNumber, body, cwd),
+};
+/**
+ * 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 function runMergeQueueCycle(options, deps = defaultDeps) {
+    const { hqPath, cwd, log, mergeMethod = 'squash', deleteBranch = true, branchPriorities, } = options;
+    const state = getMergeQueueState(hqPath);
+    state.lastCycleAt = new Date().toISOString();
+    // Step 1: Check if paused
+    if (state.paused) {
+        saveMergeQueueState(hqPath, state);
+        log?.('Merge queue is paused');
+        return { action: 'paused', queueSize: 0 };
+    }
+    // Step 2: If a PR is currently being processed, check its status
+    if (state.currentPR) {
+        const result = processCurrentPR(state, { cwd, log, mergeMethod, deleteBranch }, deps);
+        saveMergeQueueState(hqPath, state);
+        return result;
+    }
+    // Step 3: No current PR — build queue and pick next
+    const queue = buildMergeQueue({ cwd, branchPriorities }, deps);
+    log?.(`Merge queue: ${queue.length} eligible PR(s)`);
+    if (queue.length === 0) {
+        saveMergeQueueState(hqPath, state);
+        return { action: 'none', queueSize: 0 };
+    }
+    // Try to rebase the top PR — if conflicts, eject and try next
+    for (const entry of queue) {
+        const rebaseResult = deps.updatePRBranch(entry.pr.number, cwd);
+        if (rebaseResult.success) {
+            state.currentPR = {
+                prNumber: entry.pr.number,
+                headBranch: entry.pr.headBranch,
+                baseBranch: entry.pr.baseBranch,
+                ticketId: entry.ticketId,
+                priority: entry.priority,
+                rebasedAt: new Date().toISOString(),
+            };
+            log?.(`Rebased PR #${entry.pr.number} (${entry.pr.headBranch}) — waiting for CI`);
+            saveMergeQueueState(hqPath, state);
+            return { action: 'rebase_started', prNumber: entry.pr.number, queueSize: queue.length };
+        }
+        // Rebase failed — eject this PR
+        const reason = rebaseResult.hasConflicts
+            ? 'Merge conflicts during rebase'
+            : `Rebase failed: ${rebaseResult.error ?? 'unknown error'}`;
+        ejectPR(state, entry.pr.number, entry.pr.headBranch, reason, cwd, deps);
+        log?.(`Ejected PR #${entry.pr.number}: ${reason}`);
+    }
+    // All PRs in queue had conflicts
+    saveMergeQueueState(hqPath, state);
+    return { action: 'none', reason: 'All eligible PRs have conflicts', queueSize: queue.length };
+}
+// =============================================================================
+// Process Current PR
+// =============================================================================
+function processCurrentPR(state, options, deps) {
+    const { cwd, log, mergeMethod, deleteBranch } = options;
+    const current = state.currentPR;
+    const queueSize = 0; // We don't rebuild the queue when checking current
+    // Verify PR is still open
+    const prInfo = deps.getPRByNumber(current.prNumber, cwd);
+    if (!prInfo || prInfo.state !== 'OPEN') {
+        const reason = prInfo?.state === 'MERGED'
+            ? 'PR was merged externally'
+            : 'PR is no longer open';
+        log?.(`Current PR #${current.prNumber}: ${reason} — clearing`);
+        state.currentPR = null;
+        if (prInfo?.state === 'MERGED') {
+            state.lastMergedPR = {
+                prNumber: current.prNumber,
+                headBranch: current.headBranch,
+                mergedAt: new Date().toISOString(),
+            };
+        }
+        return { action: 'none', prNumber: current.prNumber, reason, queueSize };
+    }
+    // Check CI status
+    const checks = deps.getPRChecks(current.prNumber, cwd);
+    // No checks yet — still waiting
+    if (checks.length === 0) {
+        log?.(`PR #${current.prNumber}: no CI checks yet — waiting`);
+        return { action: 'waiting_ci', prNumber: current.prNumber, queueSize };
+    }
+    const failed = checks.filter(c => c.conclusion === 'FAILURE');
+    const pending = checks.filter(c => !c.conclusion || c.status === 'IN_PROGRESS' || c.status === 'QUEUED');
+    // CI still pending
+    if (pending.length > 0) {
+        log?.(`PR #${current.prNumber}: CI pending (${pending.length} check(s)) — waiting`);
+        return { action: 'waiting_ci', prNumber: current.prNumber, queueSize };
+    }
+    // CI failed — eject
+    if (failed.length > 0) {
+        const failedNames = failed.map(c => c.name).join(', ');
+        const reason = `CI failed after rebase: ${failedNames}`;
+        ejectPR(state, current.prNumber, current.headBranch, reason, cwd, deps);
+        state.currentPR = null;
+        log?.(`Ejected PR #${current.prNumber}: ${reason}`);
+        return { action: 'ejected', prNumber: current.prNumber, reason, queueSize };
+    }
+    // All CI green — merge!
+    log?.(`PR #${current.prNumber}: CI green — merging (${mergeMethod})`);
+    const mergeResult = deps.mergePR(current.prNumber, {
+        method: mergeMethod,
+        deleteBranch,
+        cwd,
+    });
+    if (!mergeResult.success) {
+        // Check if it was merged by someone else
+        const recheck = deps.getPRByNumber(current.prNumber, cwd);
+        if (recheck?.state === 'MERGED') {
+            log?.(`PR #${current.prNumber}: was merged externally`);
+            state.currentPR = null;
+            state.lastMergedPR = {
+                prNumber: current.prNumber,
+                headBranch: current.headBranch,
+                mergedAt: new Date().toISOString(),
+            };
+            return { action: 'merged', prNumber: current.prNumber, reason: 'Merged externally', queueSize };
+        }
+        const reason = `Merge failed: ${mergeResult.error}`;
+        ejectPR(state, current.prNumber, current.headBranch, reason, cwd, deps);
+        state.currentPR = null;
+        log?.(`Ejected PR #${current.prNumber}: ${reason}`);
+        return { action: 'ejected', prNumber: current.prNumber, reason, queueSize };
+    }
+    // Merge succeeded!
+    log?.(`Merged PR #${current.prNumber} (${current.headBranch})`);
+    state.currentPR = null;
+    state.lastMergedPR = {
+        prNumber: current.prNumber,
+        headBranch: current.headBranch,
+        mergedAt: new Date().toISOString(),
+    };
+    // Rebase sibling PRs
+    log?.('Rebasing sibling PRs...');
+    const siblingResult = deps.rebaseSiblingPRs({
+        excludePRNumber: current.prNumber,
+        cwd,
+        onProgress: log,
+        labelConflicts: true,
+        commentOnConflicts: true,
+    });
+    log?.(`Siblings: ${siblingResult.succeeded.length} rebased, ${siblingResult.failed.length} failed, ${siblingResult.skipped.length} skipped`);
+    return { action: 'merged', prNumber: current.prNumber, queueSize };
+}
+// =============================================================================
+// Eject PR
+// =============================================================================
+function ejectPR(state, prNumber, headBranch, reason, cwd, deps) {
+    // Record ejection
+    state.ejectedPRs.unshift({
+        prNumber,
+        headBranch,
+        reason,
+        ejectedAt: new Date().toISOString(),
+    });
+    // Keep only the last N ejected PRs
+    if (state.ejectedPRs.length > MAX_EJECTED_HISTORY) {
+        state.ejectedPRs = state.ejectedPRs.slice(0, MAX_EJECTED_HISTORY);
+    }
+    // Label and comment on the PR (best effort)
+    try {
+        deps.addLabel(prNumber, EJECTED_LABEL, cwd);
+        deps.addComment(prNumber, `${EJECTED_COMMENT_PREFIX} ${reason}`, cwd);
+    }
+    catch {
+        // Best effort — don't fail the cycle
+    }
+}
+// =============================================================================
+// Helpers
+// =============================================================================
+function allChecksGreen(checks) {
+    return checks.every(c => c.conclusion === 'SUCCESS' || c.conclusion === 'NEUTRAL' || c.conclusion === 'SKIPPED');
+}
+/**
+ * Extract a ticket ID from a branch name.
+ * Supports patterns like: PRLT-1173/feat/... or TKT-007/...
+ */
+function extractTicketIdFromBranch(branch) {
+    const match = branch.match(/^([A-Z]+-\d+)\//);
+    return match?.[1] ?? null;
+}
+//# sourceMappingURL=merge-queue.js.map

package/dist/lib/sync/merge-queue.js.map

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

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

@@ -0,0 +1,44 @@
+/**
+ * Board Sync Reconciler
+ *
+ * Core reconciliation logic that detects drift between GitHub PR state
+ * and ticket provider state, then produces corrective actions.
+ *
+ * Provider-agnostic: works with any ticket provider (Linear, PMO, etc.)
+ * and any git host that exposes PR info.
+ *
+ * Reconciliation rules:
+ * 1. Merged PR + ticket not Done → move to Done
+ * 2. Green CI + ticket In Progress → move to Review
+ * 3. Ticket In Progress + no active agent → flag as stale
+ * 4. Ticket In Review + PR closed (not merged) → move to Backlog
+ */
+import type { PRInfo, PRCheck } from '../pr/index.js';
+import type { Ticket } from '../pmo/types.js';
+export type ReconcileActionType = 'move_to_done' | 'move_to_review' | 'flag_stale' | 'move_to_backlog';
+export interface ReconcileAction {
+    type: ReconcileActionType;
+    ticketId: string;
+    ticketTitle: string;
+    reason: string;
+    /** Target status name to move to (for move actions) */
+    targetStatus?: string;
+}
+export interface ReconcileContext {
+    ticket: Ticket;
+    pr: PRInfo | null;
+    checks: PRCheck[];
+    hasActiveExecution: boolean;
+}
+export interface ReconcileResult {
+    actions: ReconcileAction[];
+    checked: number;
+    errors: Array<{
+        ticketId: string;
+        error: string;
+    }>;
+}
+/**
+ * Determine reconciliation actions for a single ticket.
+ */
+export declare function reconcileTicket(ctx: ReconcileContext): ReconcileAction | null;