export type PrState = 'QUEUED' | 'IN_BATCH' | 'TESTING' | 'FLAKE_RETRY' | 'PASSED' | 'LANDING' | 'LANDED' | 'REQUEUED_SPLIT' | 'EJECTED' | 'NEEDS_REBASE' | 'CANCELLED'
/** D13: parked by overlap_zone_policy=hold until `scaffold mq release --pr N`.
 *  Deliberately NOT terminal: `mq eject` can still cancel a held PR, and
 *  queuedPrs never selects it, so it sits outside batching until released. */
 | 'HELD_HUMAN';
export type BatchState = 'CONSTRUCTING' | 'RUNNING' | 'GREEN' | 'LANDING' | 'DONE' | 'RED' | 'SPLITTING' | 'ABORTED';
export interface PrEntry {
    pr: number;
    state: PrState;
    enqueuedAt: string;
    batchId?: string;
    /** Times this PR was ejected from a failing context (risk signal for ordering). */
    queueFailures: number;
    note?: string;
    /** D13: changed-file set cached from `gh pr diff --name-only` (pr_files event). */
    files?: string[];
    /** Head sha the cached file set was fetched at; a moved head invalidates it. */
    filesHeadSha?: string;
    /** D13: a human released this PR from an overlap-zone hold — never re-hold it
     *  (it still only ever lands solo-gated, which is what the zone protects). */
    zoneReleased?: boolean;
}
export interface BatchRecord {
    id: string;
    state: BatchState;
    members: number[];
    parent?: string;
    candidateRef: string;
    baseSha?: string;
    candidateTree?: string;
}
/** Durable tracker receipts cover post-merge closeout. Reopen remains advisory. */
export type BeadSyncAction = 'close';
export type BeadSyncResult = 'attempted' | 'succeeded' | 'failed' | 'skipped' | 'abandoned';
export interface BeadSyncRecord {
    pr: number;
    action: BeadSyncAction;
    beadId?: string;
    result: BeadSyncResult;
    attempts?: number;
    at: string;
    note?: string;
}
export type JournalEvent = {
    type: 'enqueued';
    pr: number;
    at: string;
} | {
    type: 'pr_state';
    pr: number;
    state: PrState;
    at: string;
    batchId?: string;
    note?: string;
} | {
    type: 'batch_created';
    batchId: string;
    members: number[];
    at: string;
    parent?: string;
} | {
    type: 'batch_state';
    batchId: string;
    state: BatchState;
    at: string;
    baseSha?: string;
    candidateTree?: string;
    note?: string;
} | {
    type: 'flake';
    testId: string;
    at: string;
} | {
    type: 'gate_metrics';
    batchId: string;
    seconds: number;
    result: 'green' | 'red' | 'timeout';
    at: string;
} | {
    type: 'gate_cached';
    batchId: string;
    key: string;
    savedSeconds: number;
    at: string;
} | {
    type: 'full_gate_recorded';
    tree: string;
    seconds: number;
    instrumented: boolean;
    at: string;
} | {
    type: 'bootstrap_intent';
    bootstrapId: string;
    pr: number;
    gatedHeadSha: string;
    at: string;
} | {
    type: 'bootstrap_merged';
    bootstrapId: string;
    pr: number;
    gatedHeadSha: string;
    mergeCommitSha: string;
    at: string;
} | {
    type: 'bootstrap_armed';
    bootstrapId: string;
    pr: number;
    gatedHeadSha: string;
    at: string;
} | {
    type: 'pr_files';
    pr: number;
    headSha: string;
    files: string[];
    at: string;
} | {
    type: 'released';
    pr: number;
    at: string;
} | {
    type: 'tia_recorded';
    headSha: string;
    seconds: number;
    tests: number;
    files: number;
    at: string;
} | ({
    type: 'bead_sync';
} & BeadSyncRecord);
export interface QueueState {
    entries: Map<number, PrEntry>;
    batches: Map<string, BatchRecord>;
    flakes: {
        testId: string;
        at: string;
    }[];
    beadSync: Map<string, BeadSyncRecord>;
}
export interface MergeQueueConfig {
    /** Fast merge gate; falls back to full when it cannot classify (spec D5). */
    gate_command: string;
    /** Authoritative full gate (whole-batch infra retry, post-merge parity). */
    full_gate_command: string;
    /** Batch cap when gate_command is the affected gate (spec §5.2). */
    batch_cap: number;
    poll_seconds: number;
    gate_timeout_minutes: number;
    quarantine_path: string;
    ready_label: string;
    /** Who runs the post-merge/nightly full suite (spec D4′). Not read by the daemon. */
    gate_executor: 'gha-selfhosted' | 'local-poller';
    /** D12: size cap for .mq/gate-cache.json; 0 disables the gate-result cache. */
    gate_cache_max_entries: number;
    /** D13: minimatch globs; a PR touching a zone never shares a batch. */
    overlap_zones: string[];
    /** D13: zone-touching PR handling — land it solo-gated (default) or hold it
     *  for `scaffold mq release`. */
    overlap_zone_policy: 'solo' | 'hold';
    /** D14: coverage-map recording cadence for the poller's full runs.
     *  scheduled = first green pass per UTC day (default); always; off. */
    tia: {
        record: 'scheduled' | 'always' | 'off';
    };
}
export declare function defaultMergeQueueConfig(): MergeQueueConfig;
//# sourceMappingURL=types.d.ts.map