using System.Text.Json;
using System.Threading;

namespace GB5Shared.DTO.Qualifier
{
    /// <summary>
    /// Execution context passed through every qualifier in a stage run.
    /// A single context instance is shared across all qualifiers in one execution,
    /// so each qualifier can read facts set by earlier qualifiers (L1 cache).
    /// </summary>
    public sealed class QualifierExecutionContext
    {
        /// <summary>Tenant identifier (populated from LoginDTO.TenantId).</summary>
        public int             ClientId        { get; init; }

        /// <summary>Primary key of the entity being evaluated (e.g. GopExecutionId).</summary>
        public int             EntityId        { get; init; }

        /// <summary>Entity type code matching MQUALIFIERENTITY.ENTITYCODE (e.g. "GOPEXECUTION").</summary>
        public string          EntityCode      { get; init; } = string.Empty;

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

        /// <summary>Execution scope — tinyint, matches MQUALIFIERENTITY.SCOPE.</summary>
        public byte            Scope           { get; init; }

        /// <summary>
        /// The source document provided by the caller.
        /// Qualifiers read field values from this document via JSONPath.
        /// </summary>
        public JsonDocument?   Document        { get; init; }

        /// <summary>
        /// Shared fact store for this execution.
        /// Qualifiers write outputs here; downstream qualifiers and the mapping engine read from it.
        /// </summary>
        public QualifierFactBag Facts          { get; init; } = new();

        /// <summary>Correlation ID for tracing a single execution across all qualifiers.</summary>
        public string          CorrelationId   { get; init; } = string.Empty;

        public CancellationToken CancellationToken { get; init; }
    }
}