namespace StellaOps.AdvisoryAI.Remediation;

/// <summary>
/// Type of remediation to apply.
/// </summary>
public enum RemediationType
{
    /// <summary>
    /// Bump dependency to patched version.
    /// </summary>
    Bump,

    /// <summary>
    /// Upgrade base image to newer version.
    /// </summary>
    Upgrade,

    /// <summary>
    /// Apply configuration change to mitigate.
    /// </summary>
    Config,

    /// <summary>
    /// Apply backport patch.
    /// </summary>
    Backport,

    /// <summary>
    /// Auto-detect best remediation type.
    /// </summary>
    Auto
}

/// <summary>
/// Request for generating a remediation plan.
/// Sprint: SPRINT_20251226_016_AI_remedy_autopilot
/// Task: REMEDY-01
/// </summary>
public sealed record RemediationPlanRequest
{
    /// <summary>
    /// Finding ID to remediate.
    /// </summary>
    public required string FindingId { get; init; }

    /// <summary>
    /// Artifact digest for context.
    /// </summary>
    public required string ArtifactDigest { get; init; }

    /// <summary>
    /// Vulnerability ID (CVE, GHSA, etc.).
    /// </summary>
    public required string VulnerabilityId { get; init; }

    /// <summary>
    /// Affected component PURL.
    /// </summary>
    public required string ComponentPurl { get; init; }

    /// <summary>
    /// Type of remediation to apply.
    /// </summary>
    public RemediationType RemediationType { get; init; } = RemediationType.Auto;

    /// <summary>
    /// Repository URL for PR generation.
    /// </summary>
    public string? RepositoryUrl { get; init; }

    /// <summary>
    /// Target branch for PR (default: main).
    /// </summary>
    public string TargetBranch { get; init; } = "main";

    /// <summary>
    /// Whether to generate PR immediately.
    /// </summary>
    public bool AutoCreatePr { get; init; }

    /// <summary>
    /// Correlation ID for tracing.
    /// </summary>
    public string? CorrelationId { get; init; }
}