export interface TransitionGuardResult {
    allowed: boolean;
    reason: string;
}
export interface TransitionGuardInput {
    entity: string;
    entityId: string;
    toStatus: string;
}
/**
 * Check whether a status transition is legal.
 *
 * Fail-open: if the current status cannot be read, returns
 * `{ allowed: true, reason: "lookup-failed" }`. The caller
 * should audit-log this outcome but MUST NOT block the operation.
 *
 * @param input     Entity, entity ID, and target status.
 * @param forgeRoot Absolute path to the Forge plugin root.
 */
export declare function checkTransition(input: TransitionGuardInput, forgeRoot: string): TransitionGuardResult;