Docs: Add XML docs to governance enums

Author: rian-be

src/Governance/Abstractions/Approval/Model/MutationApprovalRequirementStatus.cs

@@ -5,9 +5,24 @@ namespace ModularityKit.Mutator.Governance.Abstractions.Approval.Model;
 /// </summary>
 public enum MutationApprovalRequirementStatus
 {
+    /// <summary>
+    /// The approval requirement is still waiting for a decision.
+    /// </summary>
     Pending = 0,
+    /// <summary>
+    /// The approval requirement has been approved.
+    /// </summary>
     Approved = 1,
+    /// <summary>
+    /// The approval requirement has been rejected.
+    /// </summary>
     Rejected = 2,
+    /// <summary>
+    /// The approval requirement has been satisfied by quorum or equivalent policy.
+    /// </summary>
     Satisfied = 3,
+    /// <summary>
+    /// The approval requirement expired before it was resolved.
+    /// </summary>
     Expired = 4
 }

src/Governance/Abstractions/Lifecycle/Model/MutationRequestStatus.cs

@@ -5,12 +5,36 @@ namespace ModularityKit.Mutator.Governance.Abstractions.Lifecycle.Model;
 /// </summary>
 public enum MutationRequestStatus
 {
+    /// <summary>
+    /// The request has been created but not yet processed.
+    /// </summary>
     Created = 0,
+    /// <summary>
+    /// The request is waiting for an external governance condition.
+    /// </summary>
     Pending = 1,
+    /// <summary>
+    /// The request has been approved and may proceed to execution.
+    /// </summary>
     Approved = 2,
+    /// <summary>
+    /// The request has been rejected and will not proceed.
+    /// </summary>
     Rejected = 3,
+    /// <summary>
+    /// The request has been canceled by an explicit action.
+    /// </summary>
     Canceled = 4,
+    /// <summary>
+    /// The request expired before it could be completed.
+    /// </summary>
     Expired = 5,
+    /// <summary>
+    /// The request has been superseded by another request.
+    /// </summary>
     Superseded = 6,
+    /// <summary>
+    /// The request has been executed successfully.
+    /// </summary>
     Executed = 7
 }

src/Governance/Abstractions/Lifecycle/Model/PendingMutationReason.cs

@@ -34,5 +34,9 @@ public enum PendingMutationReason
     /// The request is waiting for manual review.
     /// </summary>
     ManualReview = 5,
+
+    /// <summary>
+    /// The request is pending because it must be revalidated against the latest state before execution.
+    /// </summary>
     Revalidation = 6
 }

src/Governance/Abstractions/Requests/Decisions/MutationRequestApprovalDecisionType.cs

@@ -5,9 +5,24 @@ namespace ModularityKit.Mutator.Governance.Abstractions.Requests.Decisions;
 /// </summary>
 public enum MutationRequestApprovalDecisionType
 {
+    /// <summary>
+    /// The approval requirement was requested.
+    /// </summary>
     Requested = 0,
+    /// <summary>
+    /// The approval requirement was granted.
+    /// </summary>
     Granted = 1,
+    /// <summary>
+    /// The approval requirement was rejected.
+    /// </summary>
     Rejected = 2,
+    /// <summary>
+    /// The approval quorum for a group was satisfied.
+    /// </summary>
     QuorumSatisfied = 3,
+    /// <summary>
+    /// The approval requirement expired.
+    /// </summary>
     Expired = 4
 }

src/Governance/Abstractions/Requests/Decisions/MutationRequestDecisionCategory.cs

@@ -5,7 +5,16 @@ namespace ModularityKit.Mutator.Governance.Abstractions.Requests.Decisions;
 /// </summary>
 public enum MutationRequestDecisionCategory
 {
+    /// <summary>
+    /// Lifecycle decisions describe request state transitions.
+    /// </summary>
     Lifecycle = 0,
+    /// <summary>
+    /// Approval decisions describe request-level approval processing.
+    /// </summary>
     Approval = 1,
+    /// <summary>
+    /// Version-resolution decisions describe stale and version-aware handling.
+    /// </summary>
     VersionResolution = 2
 }

src/Governance/Abstractions/Requests/Decisions/MutationRequestLifecycleDecisionType.cs

@@ -5,12 +5,36 @@ namespace ModularityKit.Mutator.Governance.Abstractions.Requests.Decisions;
 /// </summary>
 public enum MutationRequestLifecycleDecisionType
 {
+    /// <summary>
+    /// The request was submitted into the governance system.
+    /// </summary>
     Submitted = 0,
+    /// <summary>
+    /// The request entered a pending lifecycle state.
+    /// </summary>
     Pending = 1,
+    /// <summary>
+    /// The request was approved.
+    /// </summary>
     Approved = 2,
+    /// <summary>
+    /// The request was rejected.
+    /// </summary>
     Rejected = 3,
+    /// <summary>
+    /// The request was canceled.
+    /// </summary>
     Canceled = 4,
+    /// <summary>
+    /// The request expired before completion.
+    /// </summary>
     Expired = 5,
+    /// <summary>
+    /// The request was superseded by another request.
+    /// </summary>
     Superseded = 6,
+    /// <summary>
+    /// The request executed successfully.
+    /// </summary>
     Executed = 7
 }

src/Governance/Abstractions/Requests/Decisions/MutationRequestVersionResolutionDecisionType.cs

@@ -5,8 +5,20 @@ namespace ModularityKit.Mutator.Governance.Abstractions.Requests.Decisions;
 /// </summary>
 public enum MutationRequestVersionResolutionDecisionType
 {
+    /// <summary>
+    /// The request version matched the current state version.
+    /// </summary>
     Validated = 0,
+    /// <summary>
+    /// The request must be revalidated against the latest state.
+    /// </summary>
     RevalidationRequired = 1,
+    /// <summary>
+    /// The request must obtain renewed approval before proceeding.
+    /// </summary>
     RenewedApprovalRequired = 2,
+    /// <summary>
+    /// The request was rejected because it was stale.
+    /// </summary>
     RejectedAsStale = 3
 }

src/Governance/Abstractions/Resolution/Model/MutationRequestVersionResolutionOutcome.cs

@@ -5,8 +5,20 @@ namespace ModularityKit.Mutator.Governance.Abstractions.Resolution.Model;
 /// </summary>
 public enum MutationRequestVersionResolutionOutcome
 {
+    /// <summary>
+    /// The request can be executed with its approved version.
+    /// </summary>
     ExecuteApprovedVersion = 0,
+    /// <summary>
+    /// The request should be revalidated on the latest state.
+    /// </summary>
     RevalidateOnLatestState = 1,
+    /// <summary>
+    /// The request was rejected as stale.
+    /// </summary>
     RejectedAsStale = 2,
+    /// <summary>
+    /// The request requires renewed approval.
+    /// </summary>
     RequiresRenewedApproval = 3
 }

src/Governance/Abstractions/Resolution/Strategies/VersionedRequestResolutionStrategy.cs

@@ -5,7 +5,16 @@ namespace ModularityKit.Mutator.Governance.Abstractions.Resolution.Strategies;
 /// </summary>
 public enum VersionedRequestResolutionStrategy
 {
+    /// <summary>
+    /// Reject the request if the observed state version differs from the expected version.
+    /// </summary>
     RejectStale = 0,
+    /// <summary>
+    /// Send the request back through approval when the state has drifted.
+    /// </summary>
     RequireRenewedApproval = 1,
+    /// <summary>
+    /// Revalidate the request against the latest state before execution.
+    /// </summary>
     RevalidateOnLatestState = 2
 }