import type { DB } from '../db/namespace.js';
/** A provenance row to append to the `valve_crossing` ledger. */
export interface CrossingRecord {
    readonly valve: string;
    readonly idempotencyKey: string | null;
    readonly outcome: 'crossed' | 'blocked' | 'held' | 'failed';
    readonly payload: unknown;
    readonly detail: unknown;
    readonly lineageId: string | null;
}
/**
 * Append a crossing's provenance row to the ledger. `valve_crossing` is
 * framework substrate, so — like trace and audit — it is written with raw SQL
 * rather than the audited write surface. Runs on the caller's transaction, so
 * the row commits atomically with the crossing it records.
 */
export declare function recordCrossing(db: DB, record: CrossingRecord): Promise<void>;
/**
 * Whether a keyed crossing has already crossed — the idempotency check. A
 * `crossed` ledger row for `(valve, idempotencyKey)` means the crossing's
 * effect already landed and must not be replayed.
 */
export declare function findCrossing(db: DB, valve: string, idempotencyKey: string): Promise<boolean>;
//# sourceMappingURL=crossing-ledger.d.ts.map