namespace GB5Shared.DTO.Qualifier
{
    // ============================================================
    // Qualifier Engine Enumerations
    // Integer values match the TINYINT columns in the DB schema.
    // ============================================================

    /// <summary>Qualifier execution mode — maps to MQUALIFIERMETHOD.EXECUTIONMODE.</summary>
    public enum ExecutionMode : byte
    {
        NCalc      = 1,   // NCalc expression evaluated against FactBag
        DataSource = 2,   // GBQueryExecutor configured query
        Service    = 3    // IQualifierService registry dispatch
    }

    /// <summary>
    /// Output scope — maps to MQUALIFIEROUTPUT.OUTPUTSCOPE.
    /// Determines which section of the QualifierFactBag the output is written to.
    /// </summary>
    public enum OutputScope : byte
    {
        Document = 1,
        Line     = 2,
        Group    = 3
    }

    /// <summary>Finding severity — maps to MQUALIFIERRULECONDITION.SEVERITY.</summary>
    public enum FindingSeverity : byte
    {
        Error   = 1,
        Warning = 2,
        Info    = 3
    }

    /// <summary>
    /// DAG execution level within a qualifier plan.
    /// Qualifiers at the same level with CanRunParallel=true execute concurrently.
    /// </summary>
    public enum ExecutionLevel : byte
    {
        Level1 = 1,
        Level2 = 2,
        Level3 = 3,
        Level4 = 4,
        Level5 = 5
    }

    /// <summary>Qualifier plan cache tier.</summary>
    public enum CacheTier
    {
        /// <summary>Run-scoped Dictionary — cheapest, cleared after each execution.</summary>
        RunScoped = 0,
        /// <summary>IMemoryCache — survives across requests within the process lifetime.</summary>
        Process   = 1
    }

    /// <summary>Qualifier version lifecycle status — maps to MQUALIFIERVERSION.VERSIONSTATUS.</summary>
    public enum VersionStatus : byte
    {
        Draft    = 0,
        Active   = 1,
        Archived = 2
    }
}