using EnablementDAL.DTO;
using GB5Shared.DTO.Framework.Login;

namespace EnablementBLL.ShowResolver;

public interface IShowResolverBLL
{
    Task<ResolverResponseDTO> ResolveAsync(
        ResolverRequestDTO request,
        LoginDTO login,
        CancellationToken ct);

    // "System A" — pull/context resolver (Help Centre, Command Palette's Help
    // tab, Action Panel). Distinct from ResolveAsync ("System B" — push/event
    // resolver): ranks candidates by rule-match relevance instead of gating a
    // one-shot render batch. See ResolverMatchResultDTO for why the response
    // shape differs from ResolverActionDTO.
    Task<ResolverMatchResponseDTO> ResolveMatchesAsync(
        EnablementContextDTO context,
        LoginDTO login,
        CancellationToken ct);
}