using System.Text.Json;

namespace GB5Shared.GEF;

/// <summary>
/// Canonical GEF (Guided Execution Framework) input — the situation being evaluated. Built by the
/// calling module (SalesMind/Marketing/etc.) and passed to <see cref="IGEFEngine.EvaluateAsync"/>,
/// which maps it onto a <c>GB5Shared.DTO.Qualifier.QualifierExecutionContext</c> internally so GEF
/// reuses the existing Qualifier DAG rule engine rather than inventing a new one.
/// </summary>
public class ExecutionContextDTO
{
    /// <summary>Owning functional domain, e.g. "SALESMIND", "MARKETING".</summary>
    public string Domain { get; set; } = string.Empty;

    /// <summary>Entity type code — matches MQUALIFIERENTITY.ENTITYCODE, e.g. "SALESMIND_DEAL".</summary>
    public string EntityCode { get; set; } = string.Empty;

    /// <summary>Primary key of the entity being evaluated.</summary>
    public int EntityId { get; set; }

    /// <summary>Execution stage — tinyint, matches MQUALIFIERENTITY.STAGE.</summary>
    public byte Stage { get; set; }

    /// <summary>Role of the actor requesting guidance (e.g. "SalesRep", "Marketer").</summary>
    public string ActorRole { get; set; } = string.Empty;

    /// <summary>Optional AI/model identifier when guidance is requested on behalf of an AI-assisted flow.</summary>
    public string? ModelId { get; set; }

    /// <summary>
    /// Source facts to evaluate — same shape <c>QualifierExecutionContext.Document</c> expects.
    /// Qualifier rule conditions read field values from this document.
    /// </summary>
    public JsonDocument? Document { get; set; }
}